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-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

解决办法

  1. 用 SSH 替代 HTTPS,速度快且免登录:

    配置 SSH 密钥

    bash 复制代码
    ssh-keygen -t rsa -C "you@example.com"

    然后将 ~/.ssh/id_rsa.pub 内容复制到 GitHub SSH Keys 页面。

  2. 使用加速镜像工具(如 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 更清晰
相关推荐
love530love33 分钟前
命令行创建 UV 环境及本地化实战演示—— 基于《Python 多版本与开发环境治理架构设计》的最佳实践
开发语言·人工智能·windows·python·conda·uv
呉師傅1 小时前
佳能iR-ADV C5560复印机如何扫描文件到电脑
运维·网络·windows·计算机外设·电脑
程序视点1 小时前
【最新专业评测】PDF Reducer专业版:85%超高压缩率的PDF压缩神器|Windows最佳PDF压缩工具推荐
windows
<但凡.4 小时前
Git 完全手册:从入门到团队协作实战(4)
git·bash
qyhua4 小时前
Windows 平台源码部署 Dify教程(不依赖 Docker)
人工智能·windows·python
SugarPPig4 小时前
Git 创建一个完全没有提交历史的 master 分支
git
女程序猿!!!6 小时前
网址收集总结
windows
love530love8 小时前
Windows 如何更改 ModelScope 的模型下载缓存位置?
运维·人工智能·windows·python·缓存·modelscope
weixin_3077791314 小时前
Windows 11下纯软件模拟虚拟机的设备模拟与虚拟化(仅终端和网络)
windows·系统架构
程序员黄老师21 小时前
在 Windows 使用 Nginx/HAProxy 实现负载均衡
windows·nginx·负载均衡