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 更清晰
相关推荐
R-sz1 小时前
java流式计算 获取全量树形数据,非懒加载树,递归找儿
java·开发语言·windows
GISer_Jing8 小时前
Git协作开发:feature分支、拉取最新并合并
大数据·git·elasticsearch
柳鲲鹏8 小时前
WINDOWS最快布署WEB服务器:apache2
服务器·前端·windows
专注VB编程开发20年11 小时前
开机自动后台运行,在Windows服务中托管ASP.NET Core
windows·后端·asp.net
高山莫衣13 小时前
git rebase多次触发冲突
大数据·git·elasticsearch
码农藏经阁14 小时前
工作中常用的Git操作命令(一)
git
李洋-蛟龙腾飞公司14 小时前
HarmonyOS NEXT应用元服务常见列表操作分组吸顶场景
linux·运维·windows
kobe_OKOK_14 小时前
【团队开发】git 操作流程
git·elasticsearch·团队开发
阿幸软件杂货间15 小时前
Windows 10 2016 长期服务版
windows·系统·win10