GitHub环境配置怎么弄？分享吧详解从安装到SSH密钥的完整教程

大家好，这里是分享吧。

刚开始接触GitHub的朋友，常常会被“环境配置”这几个字搞得一头雾水。其实没那么复杂，所谓的“环境配置”，就是在你的电脑和GitHub远程仓库之间搭起一座能安全、顺畅沟通的桥梁。今天就把整个过程拆解成几个清晰的步骤，从安装到配置再到更进阶的工具，争取让你一次性搞定。

一、安装并设置Git

Git是版本控制的核心工具，也是你电脑上所有操作的基础。Windows用户可以去Git官网下载安装程序，一路默认选项即可。macOS用户可以用Homebrew安装，在终端运行brew install git。Linux用户如果是Ubuntu或Debian系统，在终端运行sudo apt update和sudo apt install git就能完成安装。

安装完成之后需要配置用户信息。打开终端，Windows用户请打开Git Bash，告诉Git你是谁。这里用的邮箱必须和你注册GitHub的邮箱一致，否则提交记录会关联不到你的账号。具体命令是git config --global user.name "你的GitHub用户名"和git config --global user.email "你的GitHub邮箱"。配置成功后输入git config --global --list可以检查一下是否设置正确。

二、配置SSH密钥

每次推送代码都输一遍账号密码，既麻烦又不安全。通过SSH密钥连接可以免去这个烦恼，也是绝大多数开发者的推荐做法。

先在终端中运行ssh-keygen -t ed25519 -C "你的GitHub邮箱"来生成密钥，一路按Enter键使用默认设置就行。生成之后需要把公钥添加到GitHub。在终端运行cat ~/.ssh/id_ed25519.pub复制输出的全部内容，然后登录GitHub点击右上角头像进入Settings，在左侧菜单找到SSH and GPG keys，点击New SSH key。填一个你记得住的名字，把刚才复制的公钥粘贴进Key文本框，最后点击Add SSH key就完成了。在终端运行ssh -T git@github.com来测试连接是否成功，如果看到Hi 用户名! You've successfully authenticated...的提示就说明一切正常。

三、安装GitHub CLI

GitHub CLI是一个命令行工具，能让你直接在终端里管理仓库、Issues、PR等操作，非常高效。macOS用户用brew install gh安装，Windows用户用winget install --id GitHub.cli，Linux用户按官方文档的步骤安装即可。安装完成后在终端运行gh auth login，按提示操作就能完成登录认证，之后在命令行里操作GitHub就方便很多了。

四、管理环境变量和Secrets

在开发或使用GitHub Actions时，经常需要配置一些敏感信息，比如API密钥，这些就是环境变量和机密。本地项目可以在根目录创建一个.env文件来存放变量，但务必记得把.env添加到.gitignore文件中，防止敏感信息被传到仓库里。

如果工作流需要这些变量，可以安全地存在GitHub上。路径是进入你的仓库找到Settings再进Secrets and variables，点击Actions，然后点击New repository secret填写名称和值就行。在工作流中可以通过${{ secrets.变量名 }}来引用这些机密，非常方便。

最后补充一点，如果你不太习惯命令行操作，可以试试github-env-manager或者VS Code里相关的图形化扩展，操作起来会更直观。另外为了让你的提交显示为“已验证”状态，可以配置GPG签名，这个属于进阶操作，有需要的时候再去了解也不迟。