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 安装与配置的核心逻辑串起来:
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 密钥配好,后面的操作才能顺风顺水。
可可精品资料库