Git安装配置全攻略：从零到起飞只需5分钟（附避坑指南）

一、安装篇：选对姿势很重要

1. Windows党必看

（1）官网下载地址：https://git-scm.com/download/win（认准这个地址别走错！）
（2）双击安装包一路Next时，这个选项必须勾选：
✅ Add Git to PATH（环境变量自动配置）
（重要程度：⭐⭐⭐⭐⭐ 忘记勾选会哭死！）

2. Mac用户专属通道

（推荐）打开终端直接开撸：

brew install git

（没装Homebrew？先跑这句：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）

3. Linux老司机专用

Ubuntu/Debian系：

sudo apt update && sudo apt install git -y

CentOS/RHEL系：

sudo yum install git -y

二、配置篇：你的数字身份证

1. 基础设置（必做！）

打开终端/CMD输入：

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

（敲黑板！！！这里的邮箱要和GitHub/GitLab注册邮箱一致！）

2. SSH密钥生成（超实用）

（1）生成密钥对：

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

（全程回车就行，但看到Enter passphrase千万别设密码！否则每次提交都要输密码烦死你）

（2）查看公钥：

cat ~/.ssh/id_ed25519.pub

复制这段长得像乱码的内容，粘贴到GitHub/GitLab的SSH Keys设置里

三、验证篇：看看是否翻车

1. 基础配置检查

git config --global --list

看到类似这样说明成功：

user.name=张三
user.email=zhangsan@example.com

2. SSH连接测试

ssh -T git@github.com

出现You've successfully authenticated就说明SSH配置成功！

四、避坑指南（血泪经验总结）

1. 中文路径报错

（典型错误）fatal: cannot create directory '中文目录'
解决方案：

git config --global core.quotepath false

2. 换行符问题

（跨平台协作必看！）
Windows用户执行：

git config --global core.autocrlf true

Mac/Linux用户执行：

git config --global core.autocrlf input

3. 大文件上传失败

（超过100MB文件GitHub直接拒收！）
终极解决方案：
✅ 使用Git LFS（Large File Storage）
✅ 把大文件加入.gitignore

五、高阶配置（装逼必备）

1. 别名设置（懒人福音）

git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch

现在可以这样用：git st = git status

2. 彩色输出

git config --global color.ui auto

3. 默认编辑器修改

（VSCode党专属）

git config --global core.editor "code --wait"

六、实战演练（手把手教学）

1. 克隆仓库的正确姿势

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

（用SSH地址比HTTPS快10倍不解释！）

2. 第一次提交标准流程

git add .
git commit -m "feat: 初始化项目"
git push -u origin main

七、常见问题Q&A

Q：为什么git命令提示不存在？

A：90%的情况是安装时没勾选PATH环境变量！重新运行安装程序勾选那个选项就行

Q：如何查看git安装位置？

where git  # Windows
which git  # Mac/Linux

Q：配置信息存哪了？

全局配置在：
Windows：C:\Users\用户名\.gitconfig
Mac/Linux：~/.gitconfig

---

最后说句大实话：很多新手卡在配置环节，其实只要跟着这篇教程走，5分钟绝对能搞定！要是还遇到问题，八成是手滑输错了什么（别问我怎么知道的…）。配置成功后建议把SSH公钥存个备份，以后重装系统能省不少事！