Git安装避坑指南大纲

Git安装避坑指南大纲

安装前的准备工作

检查操作系统版本（Windows/macOS/Linux）是否兼容目标Git版本。
确认网络环境稳定，避免下载中断。
关闭杀毒软件或防火墙，防止安装过程中误拦截关键文件。

下载官方安装包

优先从Git官网（git-scm.com）下载，避免第三方来源的篡改风险。
选择与操作系统匹配的安装包（如Windows的.exe或macOS的.dmg）。
核对安装包的哈希值或签名，确保文件完整性。

Windows系统常见问题

避免安装路径包含中文或特殊字符，可能导致命令失效。
谨慎选择默认编辑器，推荐使用Vim或Nano而非初学者不熟悉的选项。
勾选“Add Git to PATH”选项，否则无法在命令行全局调用Git。

macOS系统注意事项

使用Homebrew安装时需更新brew（brew update）再执行brew install git。
若遇到Xcode依赖问题，需提前安装Xcode Command Line Tools（xcode-select --install）。
避免使用系统自带的旧版Git，需通过安装包或Homebrew升级。

Linux系统配置

通过包管理器安装（如apt install git或yum install git），注意权限问题。
配置默认分支名称（如git config --global init.defaultBranch main）以适配现代仓库规范。
检查SSH客户端是否安装，避免后续仓库克隆失败。

安装后验证与基础配置

运行git --version确认安装成功，检查版本是否符合预期。
配置用户信息（git config --global user.name和user.email），否则提交会报错。
测试SSH密钥生成（ssh-keygen -t ed25519）及GitHub/GitLab的密钥绑定。

常见故障排除

安装后命令行无法识别Git时，检查环境变量PATH是否包含Git路径。
提交时提示“LF will be replaced by CRLF”，需调整行尾符设置（core.autocrlf）。
遇到权限问题（如macOS的“usr/local权限不足”），使用sudo或修改目录权限。

进阶优化建议

配置全局忽略文件（.gitignore_global）避免提交临时文件。
启用Git的凭证存储（如git config --global credential.helper cache）简化HTTPS验证。
考虑安装GUI工具（如GitKraken或Sourcetree）辅助可视化操作。