2、环境搭建与初始化：Windows/macOS/Linux三平台安装、Git全局配置、SSH密钥生成与GitHub/GitLab关联

好，咱们正式开始动手了。

这一章，说白了就是「把枪擦亮，子弹上膛」。不管你用 Windows、macOS 还是 Linux，都得先把 Git 装好，再把基本配置搞定。我见过太多人卡在最开始的 SSH 密钥上，折腾半天连不上远程仓库。别急，咱们一步步来。

2.1 三平台安装：各有各的脾气

先说说安装。不同系统，安装方式确实不一样。我个人的习惯是：能用包管理器就用包管理器，别去官网手动下载，除非你特别享受点「下一步」的乐趣。

Windows 平台

Windows 用户，直接去 Git 官网下载安装包就行。安装时注意几个选项：

  • 选择默认编辑器：我建议选 VSCode 或 Notepad++，别用 Vim，除非你真的很熟。
  • 调整 PATH 环境：选「Git from the command line and also from 3rd-party software」，这样你在 CMD 和 PowerShell 里都能用。
  • 换行符转换：选「Checkout Windows-style, commit Unix-style line endings」。嗯，这个很重要。我曾经因为换行符问题，整个团队的文件 diff 全是红的，那叫一个酸爽。
小提示：安装完成后，打开 CMD 或 PowerShell，输入 git --version，看到版本号就说明装好了。

macOS 平台

macOS 用户，最简单的方式是装 Xcode Command Line Tools。打开终端，敲一行命令：

xcode-select --install

它会弹窗提示你安装，点同意就行。装完自带 Git。

如果你用 Homebrew，也可以：

brew install git

我个人更推荐 Homebrew 方式，因为版本更新快，而且你可以随时升级。

Linux 平台

Linux 就简单了，一行命令搞定：

# Debian/Ubuntu
sudo apt update && sudo apt install git -y

# CentOS/RHEL/Fedora
sudo yum install git -y
# 或者
sudo dnf install git -y

装完同样验证一下：git --version。

注意：有些老系统自带的 Git 版本可能比较旧。建议装最新版，避免一些已知的 bug。我曾在 CentOS 7 上遇到过旧版本 Git 处理大文件时崩溃的问题，升级后就没事了。

2.2 Git 全局配置：你是谁？

装好 Git 后，第一件事就是告诉它「你是谁」。这可不是随便填的，每次提交代码都会带上你的名字和邮箱。

打开终端，执行：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

为什么要配这个？你想想看，团队协作时，别人看到提交记录，得知道是谁改的代码吧。我见过有人用「test」「admin」这种名字，结果出了问题根本找不到人。

除了用户名和邮箱，我建议再配几个常用的：

  • 默认分支名：现在主流都推荐用 main 而不是 master。
  • 别名：少打几个字，效率更高。
# 设置默认分支名为 main
git config --global init.defaultBranch main

# 设置别名
git config --global alias.st status
git config --global alias.ci commit
git config --global alias.br branch
git config --global alias.co checkout
git config --global alias.lg "log --oneline --graph --all"

配完后，可以用 git config --list 查看所有配置。嗯，这里要注意：全局配置保存在 ~/.gitconfig 文件里，你也可以直接编辑这个文件。

核心要点：user.name 和 user.email 是必须配的，否则你无法提交代码。其他配置看个人习惯。

2.3 SSH 密钥生成：安全第一

接下来是 SSH 密钥。说白了，就是给你的电脑配一把「钥匙」，用来和 GitHub、GitLab 这些远程仓库安全通信。不用每次输密码，方便又安全。

生成密钥很简单，打开终端，执行：

ssh-keygen -t ed25519 -C "你的邮箱@example.com"

这里我推荐用 ed25519 算法，比传统的 RSA 更安全、更快。如果你用的是很老的系统，可能不支持 ed25519，那就用 RSA：

ssh-keygen -t rsa -b 4096 -C "你的邮箱@example.com"

执行后，它会问你保存路径和密码。我一般直接回车用默认路径，密码也可以不设（但设了更安全）。

生成完成后，你会得到两个文件：

  • ~/.ssh/id_ed25519 —— 私钥，千万别泄露！
  • ~/.ssh/id_ed25519.pub —— 公钥，可以公开，要添加到远程仓库。

查看公钥内容：

cat ~/.ssh/id_ed25519.pub

复制输出的全部内容，下一步要用。

警告：私钥文件（没有 .pub 后缀的那个）绝对不能给别人看，也不能上传到任何地方。我曾经见过有人把私钥传到 GitHub 公开仓库里，结果几分钟内就被机器人扫到，服务器直接被入侵。

2.4 关联 GitHub / GitLab：把钥匙插进去

现在，把公钥添加到你的 GitHub 或 GitLab 账号里。

GitHub 添加 SSH Key

  1. 登录 GitHub，点击右上角头像 → Settings。
  2. 左侧菜单找到「SSH and GPG keys」。
  3. 点击「New SSH key」。
  4. Title 随便填，比如「我的笔记本」。
  5. Key 里粘贴刚才复制的公钥内容。
  6. 点击「Add SSH key」。

GitLab 添加 SSH Key

  1. 登录 GitLab，点击右上角头像 → Preferences。
  2. 左侧菜单找到「SSH Keys」。
  3. 在 Key 文本框里粘贴公钥内容。
  4. Title 会自动生成，也可以自己改。
  5. 点击「Add key」。

添加完成后，测试一下连接是否成功：

# 测试 GitHub
ssh -T git@github.com

# 测试 GitLab
ssh -T git@gitlab.com

如果看到类似 Hi 你的用户名! You've successfully authenticated... 的提示，就说明搞定了。

小技巧：如果你有多个 GitHub/GitLab 账号，或者想用不同的密钥连接不同的服务器，可以在 ~/.ssh/config 文件里配置。这个后面章节会详细讲。

2.5 验证一下：拉个仓库试试

环境搭好了，咱们拉个仓库试试手。随便找一个公开仓库，比如：

git clone git@github.com:你的用户名/你的仓库.git

如果克隆成功，说明整个环境搭建和 SSH 配置都没问题。

嗯，到这里，环境搭建就全部完成了。你可能会觉得步骤有点多，但相信我，一次配好，后面几年都不用再折腾。我每次换电脑，第一件事就是走一遍这个流程，已经形成肌肉记忆了。

下一章，咱们开始真正玩 Git 了——从初始化仓库到第一次提交，把代码管起来。

← 上一章 📖 返回目录 下一章 →