文章目录
前言：为什么你的Git总出问题？一、安装前的准备动作1.1 官网的正确打开方式1.2 环境检查清单
二、详细安装步骤2.1 Windows系统安装2.2 Mac用户看这里2.3 Linux极简安装
三、必须完成的配置项3.1 身份认证（重要！）3.2 避免乱码的核心设置3.3 换行符自动转换
四、进阶配置技巧4.1 配置别名（偷懒神器）4.2 SSH密钥配置4.3 配置默认编辑器
五、验证配置是否成功5.1 查看所有配置5.2 实战测试
六、常见问题排雷指南6.1 报错：Permission denied6.2 提交时提示邮箱未验证6.3 中文目录显示乱码
结语：配置不是终点
前言：为什么你的Git总出问题？
最近帮学妹调试代码时（别误会，正经教学！），发现她把git config配成了前男友的邮箱（大型社死现场）。这让我意识到，很多开发者对Git安装配置存在严重认知误区！今天就带你从底层原理出发，彻底搞定Git环境搭建。
一、安装前的准备动作
1.1 官网的正确打开方式
认准唯一官方渠道：git-scm.com（千万别百度搜"git下载"前几个结果都是广告！！！）
不同系统对应不同安装包：
Windows：选64位/32位安装程序Mac：建议用Homebrew安装（后面会教）Linux：直接用包管理器
1.2 环境检查清单
按住Win+R输入cmd打开命令行：
# 检查是否已有旧版本
git --version
如果提示"不是内部命令"说明没安装，若已有旧版本建议先卸载（新旧版本冲突血泪教训！）
二、详细安装步骤
2.1 Windows系统安装
（以v2.44.0版为例）
双击安装包进入向导选择组件时务必勾选：
Git Bash Here Git GUI Here 关联.sh文件（方便执行脚本） 选择默认编辑器时强烈推荐VSCode！环境变量选择第二项：“从命令行和第三方软件…”
2.2 Mac用户看这里
打开终端执行：
# 先安装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装Git
brew install git
（如果提示权限问题，前面加sudo然后输入密码）
2.3 Linux极简安装
Ubuntu/Debian：
sudo apt update && sudo apt install git -y
CentOS：
sudo yum install git -y
三、必须完成的配置项
3.1 身份认证（重要！）
打开Git Bash：
git config --global user.name "你的真名"
git config --global user.email "公司邮箱"
注意：
邮箱要和GitHub/Gitee注册邮箱一致中文名可能会乱码，建议用拼音
3.2 避免乱码的核心设置
git config --global core.quotepath false # 处理中文路径
git config --global gui.encoding utf-8 # 图形界面编码
3.3 换行符自动转换
# Windows用户
git config --global core.autocrlf true
# Mac/Linux用户
git config --global core.autocrlf input
（避免团队协作时的换行符战争）
四、进阶配置技巧
4.1 配置别名（偷懒神器）
把常用命令缩短：
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
现在可以用git st代替git status了！
4.2 SSH密钥配置
生成密钥对：
ssh-keygen -t ed25519 -C "你的邮箱"
把~/.ssh/id_ed25519.pub内容复制到GitHub/Gitee的SSH Keys设置页
4.3 配置默认编辑器
# 使用VSCode
git config --global core.editor "code --wait"
五、验证配置是否成功
5.1 查看所有配置
git config --list
应该看到类似：
user.name=张三
user.email=zhangsan@example.com
core.autocrlf=true
...
5.2 实战测试
创建测试仓库：
mkdir test-repo && cd test-repo
git init
echo "Hello Git" > test.txt
git add .
git commit -m "第一次提交"
如果看到类似[master (root-commit) xxxxxxx]的提示，恭喜配置成功！
六、常见问题排雷指南
6.1 报错：Permission denied
解决方法：
chmod 700 ~/.ssh
chmod 600 ~/.ssh/*
6.2 提交时提示邮箱未验证
检查：
Git配置邮箱是否与GitHub一致GitHub账号是否验证邮箱
6.3 中文目录显示乱码
在.gitconfig文件追加：
[core]
pager = less -FRX
结语：配置不是终点
记得去年用错配置导致提交记录全乱，花了一周时间修复（惨痛教训）。现在你已完成Git环境的专业级配置，但真正的挑战才刚开始。下期预告：《Git分支管理：从入门到入坟》敬请期待！
（本文配置方案已在Windows 11/MacOS Ventura/Ubuntu 22.04实测通过，遇到问题欢迎评论区交流）