以下是Git安装过程中的关键避坑指南，综合最新实践整理而成：
🔧一、安装前注意事项
- 路径选择
⚠️ 禁用中文路径或含空格路径（如C:\新建文件夹\Git），推荐全英文路径（如D:\DevTools\Git），避免权限异常和命令失效。 - 版本匹配
- Windows用户需严格区分32/64位系统（右键「此电脑」→属性查看）。
- 新手建议安装最新稳定版，企业环境可选LTS长期支持版。
- 关闭防护软件
安装前暂停360安全卫士等软件，避免误删组件导致安装失败。
⚠️二、安装中关键配置
- 环境变量设置
Windows安装时必选“Add Git to PATH”（或“Use Git from Command Prompt”），否则命令行无法识别git命令。 - 换行符处理（跨平台协作必看）
选择“Checkout Windows-style, commit Unix-style”，防止不同系统换行符冲突。 - 编辑器选择
新手避免选Vim，推荐Notepad++或VSCode，降低操作门槛。 - 组件勾选
勾选“Git Bash Here”和“Git GUI Here”，方便右键快捷操作。
🔑三、安装后必做配置
- 身份认证（立即执行！）
⚠️ 邮箱需与代码平台一致，否则提交显示匿名用户。gitconfig--globaluser.name"你的用户名"gitconfig--globaluser.email"GitHub/GitLab注册邮箱" - 生成SSH密钥（免密推送必备）
完成后测试连接：ssh-keygen-ted25519-C"邮箱"# 2025年推荐加密算法cat~/.ssh/id_ed25519.pub# 复制公钥到GitHub/GitLabssh -T git@github.com。 - 解决SSL证书错误
若遇fatal: unable to access...，切换仓库协议：gitremote set-url origin git@github.com:用户名/仓库.git# HTTPS切SSH
🚑四、常见故障排查
| 问题现象 | 解决方案 | 来源 |
|---|---|---|
Permission denied (publickey) | 检查公钥是否绑定平台，重绑后执行ssh -T测试 | |
git: command not found | 检查环境变量PATH是否包含Git安装路径（如C:\Program Files\Git\cmd） | |
提交提示anonymous | 重新配置user.name和user.email | |
| 大文件推送失败（>100MB） | 安装Git LFS：git lfs track "*.psd" |
💡五、高级优化建议
- 多账号切换：
创建不同SSH密钥对，通过~/.ssh/config文件区分仓库。 - 加速访问：
配置代理：gitconfig--globalhttp.proxy http://127.0.0.1 - 别名简化命令：
gitconfig--globalalias.st status# `git st`代替`git status`
💎避坑口诀：路径纯英文、变量加PATH、装完配身份、密钥绑平台！
按此流程操作可规避90%安装问题，若遇环境冲突（如旧版本残留），彻底卸载后重装。
