💻 Git 安装闭坑指南(仅 Windows 环境)
适用人群 :刚开始用 Git 的 Windows 用户;重新配置开发环境的程序员;不想踩坑的团队小伙伴
目标:快速、稳定地安装 Git,在各种常见场景下避免"下载不了、命令用不了、编码乱码、权限错乱"等问题。
🧩 安装前准备
✅ 1. 确保没有老版本冲突
场景案例 :
你装过某些 IDE(如 VS Code、SourceTree)或 Git 客户端(如 TortoiseGit),它们可能已经偷偷装了 Git,路径可能乱七八糟。
解决办法:
-
打开命令行(Win+R → 输入
cmd
):bashwhere git
如果显示多个路径,比如:
C:\Program Files\Git\bin\git.exe C:\Users\zhichao\AppData\Local\Programs\Git\cmd\git.exe
➤ 建议卸载所有 Git 版本,并手动删除这些目录,重新干净安装。
🧰 推荐安装方式
✅ 2. 下载推荐地址(避开镜像慢/官网连不上)
- 推荐下载源 :
- Git 官方镜像(国内较慢):https://git-scm.com/
下载 Git-2.x.x-64-bit.exe
安装包,不要用 Windows Store 版本(它权限有问题且难以配置)。
🛠️ 安装步骤推荐配置(全图形界面,点 Next 的时候注意这几项)
✅ 3. 安装时重点设置项(别一股脑全默认)
步骤 | 选项 | 推荐选择 | 理由 |
---|---|---|---|
1 | Adjusting PATH | Git from the command line and also from 3rd-party software | 让所有终端(如 CMD/Powershell)都能用 git 命令 |
2 | Configuring line ending conversions | Checkout as-is, commit as-is | 防止 Windows/Linux 来回换行符转换导致代码 diff 混乱 |
3 | Choosing HTTPS transport backend | Use the OpenSSL library | 支持更多 HTTPS 地址,兼容 GitHub 等平台 |
4 | Configuring the terminal emulator | Use MinTTY (the default terminal) | 更好看的终端界面,支持复制粘贴 |
5 | Default editor used by Git | 推荐选择 Visual Studio Code (或你常用的编辑器) |
git commit 等会自动调用 |
❗ 安装后常见问题与解决方案
🧨 问题1:安装完成后 git 命令无效
场景 :
输入 git --version
提示 'git' 不是内部或外部命令
。
解决办法:
-
可能是环境变量未添加成功。
-
手动添加系统环境变量:
控制面板 → 系统 → 高级系统设置 → 环境变量 → 系统变量
Path
→ 加入:C:\Program Files\Git\cmd
🧨 问题2:Git Bash 中文乱码 / 文件名乱码
场景 :
中文显示为乱码,或 git status
中文文件名显示问号。
解决办法:
-
修改默认编码:
bashgit config --global core.quotepath false git config --global gui.encoding utf-8 git config --global i18n.commitencoding utf-8 git config --global i18n.logoutputencoding utf-8
-
修改 Git Bash 字体:
- 打开 Git Bash → 右键标题栏 → Options → Text → Font → 选择支持中文的字体如
Consolas
或新宋体
- 打开 Git Bash → 右键标题栏 → Options → Text → Font → 选择支持中文的字体如
🧨 问题3:克隆 GitHub 项目报错,SSL 问题
报错:
SSL certificate problem: unable to get local issuer certificate
解决办法 :
执行以下命令绕过验证(仅限临时使用):
bash
git config --global http.sslVerify false
长期解决方案 :
确保安装的是带 OpenSSL 的 Git 版本;不要在公司网络下抓 GitHub,可以考虑用 VPN 或离线镜像克隆。
🧨 问题4:拉取/提交速度极慢 or 403 报错
场景:
- clone GitHub 仓库非常慢甚至超时
- 报错
403 Forbidden
解决办法:
-
用 SSH 替代 HTTPS,速度快且免登录:
配置 SSH 密钥:
bashssh-keygen -t rsa -C "you@example.com"
然后将
~/.ssh/id_rsa.pub
内容复制到 GitHub SSH Keys 页面。 -
使用加速镜像工具(如
ghproxy.com
):bashgit clone https://ghproxy.com/https://github.com/xxx/yyy.git
🎯 验证安装是否成功
bash
git --version
git config --list
git clone https://github.com/git/git.git
如果能看到版本号、配置项、并顺利 clone 项目,说明一切正常 ✅。
🎁 附加工具推荐
工具 | 说明 |
---|---|
TortoiseGit | Windows 下最强图形 Git 工具 |
GitHub Desktop | GitHub 官方客户端,适合新手 |
Fork | 专业级 GUI 工具,轻量好用 |
GitLens (VSCode 插件) | 让 Git 提交历史、blame 更清晰 |