Git 安装与配置
好,说完版本管理的理念,咱们得先把工具装好。Git 是分布式版本控制的基石,装完还得配好,不然提交记录里的作者信息全是乱码,远程仓库也连不上。这一章我带你走一遍完整的安装和配置流程,从 Windows 到 Linux,再到 SSH 密钥绑定,一步不落。
跨平台安装:你的系统该用哪种方式?
Git 支持所有主流操作系统。但不同平台的安装方式略有差异,这里我按平台分开讲。
Windows 平台
去 Git 官网下载安装包,双击运行。安装向导里有几个关键选项,我建议你注意一下:
- 选择默认编辑器:保留 Vim 可以,但如果你不熟悉 Vim,选 Notepad++ 或 VS Code 会舒服很多。
- 调整 PATH 环境变量:选“Git from the command line and also from 3rd-party software”,这样 Git 命令在 cmd 和 PowerShell 里都能直接用。
- 行尾转换:Windows 选“Checkout Windows-style, commit Unix-style line endings”。这是为了避免团队跨平台协作时的换行符问题。我在项目中见过因为行尾不一致导致的合并冲突,排查起来特别头疼。
macOS 平台
最简单的办法是装 Xcode Command Line Tools,Xcode 里自带 Git。但版本可能不是最新的。我习惯用 Homebrew 安装:
brew install git
装完可以检查版本确认一下:
git --version
Linux 平台
Debian/Ubuntu 系列用 apt,Red Hat/CentOS 用 yum。命令很简单:
sudo apt update
sudo apt install git # Ubuntu/Debian
sudo yum install git # CentOS/RHEL 7
sudo dnf install git # Fedora/RHEL 8+
嗯,这里要注意。Linux 发行版仓库里的 Git 版本可能比较旧。如果团队要求特定版本,我建议从源码编译,或者加 PPA(Ubuntu)获得新版。
全局配置:让每一次提交都有名有姓
安装完 Git,第一件事就是设置你的用户名和邮箱。这个信息会写入每一次提交记录。不配的话,提交时 Git 会报错,或者用系统默认的奇怪名字填进去。我之前接手过一个项目,里面一堆提交作者是“Unknown”,根本没法追溯是谁改的代码。
配置命令分两级:全局 和 项目级。全局配置影响你机器上的所有仓库,项目级配置只覆盖当前仓库。一般先设全局,特殊情况再改项目级。
设置全局用户名和邮箱
git config --global user.name "你的名字(拼音或真名)"
git config --global user.email "你的邮箱(建议与远程仓库绑定的邮箱一致)"
为什么要强调邮箱一致?因为 GitHub/GitLab 上的 commit,如果邮箱和你账号绑定的邮箱不匹配,它就不会关联到你的账号头像和贡献图。说白了,你的劳动成果会变成“匿名”的。
检查配置是否生效:
git config --global --list
如果你只想给当前项目换一个名字和邮箱(比如工作项目用公司邮箱,个人项目用私人邮箱),不加 --global 就行:
cd /path/to/your/repo
git config user.name "项目专用名字"
git config user.email "项目专用邮箱"
SSH 密钥生成与绑定:安全连接远程仓库
配好身份信息,接下来就是打通和远程仓库的网络通道。我个人习惯用 SSH 协议,因为比 HTTPS 更安全,而且免密码推送。你想想看,如果用 HTTPS,每次推送都要输账号密码,多烦人。
生成 SSH 密钥
打开终端(Windows 上建议用 Git Bash)。先检查有没有现成的密钥:
ls -al ~/.ssh
如果看到 id_rsa 和 id_rsa.pub,说明已有密钥对,可以跳过生成步骤。如果需要重新生成,运行:
ssh-keygen -t rsa -b 4096 -C "你的邮箱,最好是提交邮箱"
命令执行后,会提示你选择保存路径和设置密码(passphrase)。
- 保存路径:直接回车用默认
~/.ssh/id_rsa就好。 - 密码:建议设置。这样即使密钥文件泄露,没有密码对方也无法使用。不过,如果你经常推送代码,每次都输密码确实烦。我推荐用
ssh-agent来管理密码,只需输入一次。
启动 ssh-agent 并添加密钥
在 macOS 和 Linux 上,后台启动 agent 并添加密钥:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa
在 Windows Git Bash 里,命令类似。如果遇到权限问题,可以试试:
eval $(ssh-agent -s)
ssh-add ~/.ssh/id_rsa
将公钥绑定到远程仓库平台
生成密钥后,我们需要把 公钥 添加到 GitHub/GitLab/Bitbucket 等平台。公钥的默认位置是 ~/.ssh/id_rsa.pub。复制它的内容:
cat ~/.ssh/id_rsa.pub
你会看到一串以 ssh-rsa 开头、以你的邮箱结尾的字符串。把它完整复制下来。
然后登录你的远程仓库平台:
- GitHub:Settings → SSH and GPG keys → New SSH key → 粘贴公钥 → Add SSH key。
- GitLab:Settings → SSH Keys → 粘贴公钥 → Add key。
- Bitbucket:Personal settings → SSH keys → Add key。
千万不要把私钥(id_rsa)泄露出去! 私钥是你的数字身份,丢了就等于别人可以冒充你操作仓库。我曾经有一次不小心把私钥提交到了公共仓库,虽然很快删除了,但不放心,还是重新换了密钥对。
验证连接
绑定完公钥,测试一下连接是否成功:
ssh -T git@github.com # GitHub
ssh -T git@gitlab.com # GitLab
ssh -T git@bitbucket.org # Bitbucket
如果看到类似 Hi username! You've successfully authenticated 的提示,说明 SSH 连接建立成功。嗯,这里要注意。第一次连接会提示确认主机的指纹,输入 yes 即可。
配置流程总结
走到这一步,Git 在你的机器上就算安家落户了。安装对了,配置清了,SSH 也连上了——后面我们再聊怎么用它来管理力场文件,你就会感觉顺手很多。