以下是 Windows、Linux、macOS 三大系统安装 Git 的常见坑点及解决方案,附带 具体操作示例,帮助新手快速避坑。
一、Windows 系统安装 Git
1. 安装路径含空格或中文
坑点:默认路径 C:\Program Files\Git
可能导致某些脚本报错。
解决:自定义路径(如 D:\DevTools\Git
)。
# 安装时手动修改路径为全英文无空格
D:\DevTools\Git
2. 未添加 Git 到 PATH
坑点:CMD 中 git --version
提示“不是内部命令”。
解决:安装时勾选 Use Git from the command line
(老版本)或 Add Git to PATH
(新版本)。
3. 换行符问题(CRLF/LF)
坑点:跨平台协作时文件换行符混乱。
解决:安装时选择:
Checkout as-is, commit as-is
或运行:
git config --global core.autocrlf input
4. SSH 密钥权限错误
坑点:Permission denied (publickey)
。
解决:生成密钥并添加到 GitHub:
ssh-keygen -t ed25519 -C "your_email@example.com"
cat ~/.ssh/id_ed25519.pub | clip # 复制到剪贴板
# 粘贴到 GitHub SSH Keys
二、Linux 系统安装 Git
1. 系统仓库版本过旧
坑点:apt
/yum
安装的 Git 版本低。
解决(Ubuntu):
sudo add-apt-repository ppa:git-core/ppa -y
sudo apt update
sudo apt install git
2. SSH 密钥配置失败
坑点