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 安装与配置核心流程 1. 跨平台安装 Git 2. 全局用户配置 3. SSH 密钥生成 Windows: 安装包安装 macOS: brew install Linux: apt/yum/dnf user.name 设置 user.email 设置 项目级可覆盖 ssh-keygen 生成 ssh-agent 管理密码 公钥绑定平台 4. SSH 连接验证:ssh -T git@github.com

走到这一步,Git 在你的机器上就算安家落户了。安装对了,配置清了,SSH 也连上了——后面我们再聊怎么用它来管理力场文件,你就会感觉顺手很多。