3、Git安装与配置：Windows/Mac/Linux安装、全局配置、SSH密钥配置

好，咱们正式开始动手了。这一章我带你搞定Git的安装和基础配置。说实话，很多新手在这步容易翻车，尤其是SSH密钥那块。我当年第一次配的时候，折腾了快两个小时，最后发现是路径写错了。嗯，咱们一步步来，别急。

3.1 各平台安装指南

Git的安装其实挺简单的。说白了，就是个下一步下一步的事儿。但不同系统有些小细节，我帮你捋一遍。

Windows安装

Windows用户直接去官网下载安装包就行。我个人习惯选64位版本。安装时注意几个点：

  • 选择组件：记得勾选「Git Bash Here」和「Git GUI Here」，右键菜单会方便很多
  • 默认编辑器：我建议选VSCode或者Notepad++，别用Vim，除非你习惯用
  • PATH环境：选「Git from the command line and also from 3rd-party software」
  • 换行符处理：选「Checkout Windows-style, commit Unix-style line endings」
我的小经验：安装路径别带中文和空格。我之前有个同事装在了「Program Files (x86)」里，后来有些脚本跑起来各种报错，折腾半天才发现是路径问题。

Mac安装

Mac用户就幸福多了。最简单的方式是用Homebrew：

brew install git

如果你没装Homebrew，去官网下载dmg安装包也行。我个人更推荐Homebrew，因为后续更新方便：

brew upgrade git

对了，Mac自带的Git版本通常比较老。我建议还是装个新的。你想想看，老版本有些功能不支持，比如git switch这种好用的命令。

Linux安装

Linux用户直接用包管理器就行。不同发行版命令略有不同：

发行版 安装命令
Ubuntu/Debian sudo apt install git
CentOS/RHEL sudo yum install git
Fedora sudo dnf install git
Arch Linux sudo pacman -S git

装完之后，验证一下：

git --version

看到版本号就说明装好了。

3.2 全局配置：你是谁？

装好Git之后，第一件事就是告诉Git你是谁。这个信息会记录在你每次提交里。说白了，就是给你的代码打上签名。

配置用户名和邮箱：

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

为什么要配这个？我举个例子。有一次我们团队排查一个线上bug，发现某次提交引入了问题。但提交者的名字是空的，根本不知道是谁改的。嗯，那场面，挺尴尬的。

注意：邮箱最好用你GitHub/GitLab上注册的那个。这样提交记录才能关联到你的账号头像和贡献图。

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

git config --global core.autocrlf input   # Mac/Linux推荐
git config --global core.autocrlf true    # Windows推荐
git config --global core.editor "code --wait"  # 设置默认编辑器为VSCode
git config --global init.defaultBranch main    # 默认分支名改为main

查看所有配置：

git config --list --global

配置文件的存放位置：

  • Windows：C:\Users\你的用户名\.gitconfig
  • Mac/Linux：~/.gitconfig

你也可以直接编辑这个文件，效果和命令行一样。

3.3 SSH密钥配置：安全连接

接下来是重头戏。SSH密钥配置，说白了就是让你的电脑和远程仓库（比如GitHub）建立安全连接。不用每次操作都输密码。

生成SSH密钥

打开终端（Windows用Git Bash），执行：

ssh-keygen -t ed25519 -C "你的邮箱"

这里我推荐用ed25519算法，比传统的RSA更安全，速度也更快。如果你用的是比较老的系统，可以用RSA：

ssh-keygen -t rsa -b 4096 -C "你的邮箱"

执行后会问你保存路径和密码。我一般直接回车用默认路径，密码也留空。当然，如果你对安全性要求高，可以设个密码。

密钥文件说明：

  • ~/.ssh/id_ed25519 — 私钥，打死也不能给别人看
  • ~/.ssh/id_ed25519.pub — 公钥，可以公开，要添加到远程仓库

添加公钥到远程仓库

先查看公钥内容：

cat ~/.ssh/id_ed25519.pub

复制输出的内容。然后去你的GitHub/GitLab/Gitee：

  1. 登录账号，进入Settings
  2. 找到SSH and GPG keys
  3. 点击New SSH key
  4. 粘贴公钥，起个名字（比如「我的笔记本」）
  5. 保存

测试连接

配置好之后，测试一下：

ssh -T git@github.com

如果看到类似这样的输出，就说明成功了：

Hi 你的用户名! You've successfully authenticated, but GitHub does not provide shell access.
避坑指南：我曾经遇到过一个问题，明明密钥配好了，但就是连不上。后来发现是~/.ssh目录权限不对。修复方法： 
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub

多账号配置（进阶）

如果你有多个Git账号（比如工作和个人），可以配置config文件。在~/.ssh/config里写：

# 个人账号
Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_personal

# 工作账号
Host github-work
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_work

这样就能区分不同场景了。我个人习惯把工作和个人分开，避免不小心把公司代码提交到个人仓库。

3.4 验证配置

最后，咱们验证一下所有配置是否生效：

# 查看全局配置
git config --global --list

# 查看SSH密钥列表
ssh-add -l

# 测试SSH连接
ssh -T git@github.com

如果一切正常，恭喜你，Git环境就搭好了。接下来就可以愉快地使用Git了。

本章小结：

  • 各平台安装Git，注意Windows的换行符设置
  • 配置user.name和user.email，这是提交记录的身份证
  • 生成SSH密钥，添加到远程仓库，实现免密操作
  • 多账号场景下配置config文件

嗯，配置这块就这些。别嫌麻烦，一次配好，后面能省很多事。下一章咱们聊聊Git的基本工作流程，到时候你就知道这些配置有多重要了。

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