第3章：Git安装与配置——在Windows/Mac/Linux上安装Git，配置用户信息与SSH密钥

说实话，很多新手在Git上栽跟头，不是栽在命令上，而是栽在安装和配置上。我见过太多人装完Git就开始敲代码，结果提交记录里用户名乱写，SSH连不上服务器，折腾半天才发现是配置没搞对。

这一章，咱们就把安装和配置这件事彻底讲透。你跟着我走一遍，以后就不会再在这些基础问题上浪费时间了。

3.1 各平台安装Git

Git的安装其实很简单，但不同平台有不同讲究。我分别说说。

Windows 安装

Windows用户直接去官网下载安装包就行。但我建议你注意几个选项：

  • 选择默认编辑器：我个人习惯选VS Code，别用Vim，除非你真的很熟Vim
  • 调整PATH环境变量：选"Git from the command line and also from 3rd-party software"
  • 换行符转换：选"Checkout Windows-style, commit Unix-style line endings"——这个坑我踩过，后面细说
小技巧：安装时勾选"Enable Git Credential Manager"，后面推代码就不用反复输密码了。

macOS 安装

Mac用户有两种方式。如果你装了Homebrew，一行命令搞定：

brew install git

没装Homebrew？直接去git-scm.com下载dmg安装包也行。但我建议你装Homebrew，后面管理开发工具方便很多。

Linux 安装

Linux最简单，包管理器一把梭：

# Ubuntu/Debian
sudo apt-get install git

# CentOS/RHEL
sudo yum install git

# Fedora
sudo dnf install git

装完验证一下：

git --version

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

3.2 配置用户信息

装完Git第一件事是什么？配置用户名和邮箱。这步不做，你的提交记录里就是一堆"Unknown"，到时候想找谁写的代码都找不到。

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

这里有个细节——--global表示全局配置，对所有仓库生效。如果你某个项目想用不同的身份，可以去掉--global，在项目目录里单独设置：

git config user.name "项目专用名字"
git config user.email "项目专用邮箱"

查看配置：

git config --list
注意：邮箱一定要用GitHub/GitLab上注册的那个。我曾经有个同事用了公司邮箱，结果GitHub上提交记录显示的不是他的账号，排查了半天。

3.3 配置SSH密钥

为什么要配SSH？说白了，就是让你不用每次推代码都输密码。HTTPS方式每次都要验证身份，SSH配好了一劳永逸。

生成密钥对

打开终端，执行：

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

然后一路回车就行。如果你想给密钥加个密码，可以设置passphrase——但我个人建议别加，不然每次用都要输密码，反而麻烦。

生成的文件默认在~/.ssh/目录下：

  • id_rsa：私钥，自己留着，千万别泄露
  • id_rsa.pub：公钥，可以公开，要添加到远程仓库

添加公钥到远程仓库

先查看公钥内容：

cat ~/.ssh/id_rsa.pub

复制输出的全部内容。然后：

  • GitHub：Settings → SSH and GPG keys → New SSH key
  • GitLab：Settings → SSH Keys → Add key
  • Gitee：设置 → SSH公钥 → 添加公钥

把公钥粘贴进去，保存。

测试连接

ssh -T git@github.com

看到类似"Hi xxx! You've successfully authenticated"就说明配好了。

避坑指南：如果测试时提示"Permission denied"，先检查~/.ssh/目录权限。执行chmod 700 ~/.ssh和chmod 600 ~/.ssh/id_rsa。我曾经在这上面卡了半小时，最后发现是权限问题。

3.4 多SSH密钥管理

如果你有多个Git账号（比如公司GitLab和个人GitHub），就需要配置多个SSH密钥。

生成时指定文件名：

ssh-keygen -t rsa -b 4096 -C "公司邮箱" -f ~/.ssh/id_rsa_company
ssh-keygen -t rsa -b 4096 -C "个人邮箱" -f ~/.ssh/id_rsa_personal

然后在~/.ssh/config文件里配置：

# 公司GitLab
Host gitlab.company.com
  HostName gitlab.company.com
  User git
  IdentityFile ~/.ssh/id_rsa_company

# 个人GitHub
Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_rsa_personal

这样Git就会根据你连接的域名自动选择对应的密钥。

3.5 常用配置一览

除了用户信息和SSH，还有一些配置我建议你顺手设好：

配置项 命令 说明
默认分支名 git config --global init.defaultBranch main 新仓库默认用main，别再用master了
别名 git config --global alias.st status 用git st代替git status
颜色显示 git config --global color.ui auto 让输出带颜色，看着舒服
换行符处理 git config --global core.autocrlf true Windows用true，Mac/Linux用input

核心要点：安装Git只是第一步，配置才是关键。用户信息、SSH密钥、换行符处理，这三样配好了，后面基本不会出幺蛾子。

嗯，这一章的内容就这些。安装和配置看起来琐碎，但确实是最容易出问题的地方。你按我说的走一遍，后面用Git就会顺畅很多。下一章咱们开始讲Git的核心操作——提交、分支、合并，那才是真正有意思的部分。

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