3、Git安装与配置:Windows/Mac/Linux下的Git安装、全局配置(user.name、user.email)、SSH密钥配置

说实话,Git 的安装和配置,是每个版本管理工程师的「入门第一课」。我见过不少新手,代码写得挺溜,结果卡在 Git 环境搭建上,一卡就是半天。今天咱们就把这事儿彻底捋清楚。

核心要点:Git 安装不难,但全局配置和 SSH 密钥是后续所有操作的基础。搞不定这两步,后面寸步难行。

3.1 各平台下的 Git 安装

先说说安装。不同操作系统,安装方式略有差异。我个人的习惯是:能用包管理器就用包管理器,省心。

Windows 安装

Windows 下最推荐的方式是下载官方安装包。去 Git 官网下载 Git for Windows,一路 Next 就行。但有几个选项要注意:

  • 选择默认编辑器:我建议选 VSCode 或 Notepad++,别用 Vim(除非你真的很熟)
  • 调整 PATH 环境:选「Git from the command line and also from 3rd-party software」
  • 换行符转换:选「Checkout Windows-style, commit Unix-style line endings」——这个坑我踩过,后面细说

小技巧:安装完成后,在命令行输入 git --version 验证。如果显示版本号,说明装好了。

macOS 安装

Mac 用户有两种选择:

  • Homebrew 安装(推荐):brew install git
  • Xcode Command Line Tools:xcode-select --install

我个人更倾向 Homebrew,因为后续更新方便。你想想看,用 brew upgrade git 就能搞定,多省事。

Linux 安装

Linux 下最简单,一行命令搞定:

# Debian/Ubuntu
sudo apt-get install git

# CentOS/RHEL
sudo yum install git

# Fedora
sudo dnf install git

嗯,这里要注意:有些老版本 Linux 自带的 Git 版本太旧。我曾经在 CentOS 7 上遇到过,默认装的是 1.8 版本,连 git switch 命令都不支持。建议装完检查一下版本,太旧就手动编译安装。

3.2 全局配置:user.name 和 user.email

装好 Git 后,第一件事就是配置身份信息。说白了,就是告诉 Git「你是谁」。每次提交代码时,这些信息会记录在提交历史里。

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

为什么要做这一步?我举个例子。有一次团队里来了个新人,没配 user.name 就直接提交了。结果代码审查时,根本不知道是谁写的。后来查日志,显示的是 Unknown,你说尴尬不尴尬?

避坑指南:我曾经遇到过,有人把公司邮箱和个人邮箱搞混了。提交记录里全是个人邮箱,合规检查时被点名批评。所以,一定要用公司邮箱。

配置完成后,可以用以下命令查看:

git config --global --list

如果只想看某个配置项:

git config user.name
git config user.email

3.3 SSH 密钥配置

SSH 密钥,说白了就是你的「数字身份证」。有了它,就不用每次操作都输密码了。我刚开始用 Git 时,觉得配 SSH 麻烦,一直用 HTTPS。结果每次 push 都要输账号密码,一天下来手都酸了。后来配了 SSH,真香。

生成 SSH 密钥

打开终端,执行:

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

命令执行后,会问你保存路径和密码。我一般直接回车,用默认路径。密码可以设也可以不设,看你的安全要求。

小技巧:如果设了密码,可以用 ssh-agent 记住它,省得每次都用输入。

添加密钥到 SSH Agent

# 启动 ssh-agent
eval "$(ssh-agent -s)"

# 添加私钥
ssh-add ~/.ssh/id_rsa

查看并添加公钥到 Git 平台

先查看公钥内容:

cat ~/.ssh/id_rsa.pub

复制输出的内容,然后登录你的 Git 平台(GitHub、GitLab、Gitee 等),在设置中找到「SSH Keys」或「SSH公钥」,粘贴保存。

避坑指南:我曾经见过有人把私钥(id_rsa)当成公钥上传了。记住:上传的是 .pub 文件的内容,私钥绝对不能泄露。

验证配置是否成功

ssh -T git@github.com

如果看到类似 Hi 用户名! You've successfully authenticated 的提示,说明配置成功了。

3.4 知识体系总览

下面这张图,帮你把 Git 安装与配置的核心逻辑串起来:

Git 安装与配置知识体系 Git 安装 全局配置 SSH 密钥配置 Windows 安装 macOS 安装 Linux 安装 user.name user.email 配置验证 生成密钥对 添加 SSH Agent 上传公钥到平台 配置完成后 → 验证连通性 → 开始使用 Git

3.5 常见问题与排查

配置过程中,难免会遇到问题。我整理了几个高频问题:

问题 原因 解决方法
Permission denied (publickey) SSH 密钥未正确配置 检查公钥是否已上传到 Git 平台,确认使用的是正确的密钥
git: command not found Git 未安装或未加入 PATH 重新安装,或手动添加 Git 到环境变量
Please tell me who you are 未配置 user.name 和 user.email 执行 git config --global 配置

我的经验:遇到问题别慌。先看错误信息,大部分问题都能从提示中找到线索。实在不行,把错误信息复制到搜索引擎里,十有八九能找到答案。

好了,Git 安装与配置就讲到这里。记住:安装只是开始,配置才是关键。把 user.name、user.email 和 SSH 密钥配好,后面的操作才能顺风顺水。


可可精品资料库