Git 安装闭坑指南（仅 Windows 环境）
💻 Git 安装闭坑指南（仅 Windows 环境）
适用人群 ：刚开始用 Git 的 Windows 用户；重新配置开发环境的程序员；不想踩坑的团队小伙伴
目标：快速、稳定地安装 Git，在各种常见场景下避免"下载不了、命令用不了、编码乱码、权限错乱"等问题。
🧩 安装前准备
✅ 1. 确保没有老版本冲突
场景案例 ：
你装过某些 IDE（如 VS Code、SourceTree）或 Git 客户端（如 TortoiseGit），它们可能已经偷偷装了 Git，路径可能乱七八糟。
解决办法：
打开命令行（Win+R → 输入 cmd）：
bash
复制代码
where 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 中文文件名显示问号。
解决办法：
修改默认编码：
bash
复制代码
git 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 或 新宋体
🧨 问题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 密钥：
bash
复制代码
ssh-keygen -t rsa -C "you@example.com"
然后将 ~/.ssh/id_rsa.pub 内容复制到 GitHub SSH Keys 页面。
使用加速镜像工具（如 ghproxy.com）：
bash
复制代码
git 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 更清晰