Git安装避坑指南

系统环境准备

检查操作系统版本（Windows/macOS/Linux）及兼容性
确保管理员权限或sudo权限可用
关闭杀毒软件或防火墙的临时干扰

下载官方安装包

从Git官网（https://git-scm.com/）获取最新稳定版本
避免第三方来源的修改版或捆绑软件

Windows系统注意事项

勾选“Use Git from the Windows Command Prompt”以全局调用
谨慎选择“Checkout as-is, commit Unix-style line endings”避免换行符问题
添加Git到PATH环境变量（避免后续命令无法识别）

macOS系统注意事项

通过Homebrew安装时检查依赖完整性（如Xcode Command Line Tools）
避免使用系统自带的旧版Git

Linux系统注意事项

优先使用发行版官方仓库（如apt/yum）安装
源码编译时确保开发工具链（gcc, make）已安装

配置初始设置

设置用户名和邮箱（避免提交时无作者信息）

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

调整默认文本编辑器（如避免Vi初学者误操作）

常见安装问题排查

安装后git --version无响应的PATH配置修复
SSL证书错误时的代理或证书设置
中文路径或用户名导致的权限异常

验证安装成功

运行基础命令验证：

git --version
git config --list

创建测试仓库并完成一次提交

进阶工具集成（可选）

配置Git GUI工具（如SourceTree、GitKraken）
SSH密钥生成与GitHub/GitLab绑定