蓝盐泳池1983在Windows下装Git，表面上就是一个exe的事，但这类工具恰恰是"安装只要十分钟，配置能坑一下午"的典型。我自己带过不少同事，也帮人在线排查过环境问题，最常见的剧本是这样的：官网下载页打开慢，安装包半天下不下来；好不容易装完了，打开cmd敲git version，却冒出一句'不是内部或外部命令'；后来用HTTPS克隆仓库，又碰到凭据弹窗反复出现；换成SSH方式，又报Permission denied。这篇文章把Windows下安装Git从下载、安装、初始化配置到高频报错排查的完整流程拆开讲一遍，基本照着做就能一遍过，顺便把安装背后那些概念也捋清楚。
1. 开始之前：你下载的Git其实是一套组合工具
1.1 一个安装包，实际给了你三样东西
很多人对"安装Git"有个误会，以为装完就是一个能敲git命令的软件。实际上，Git本身是一个命令行版本控制工具，而Windows上安装的"Git for Windows"是一个打包发行版，里面包含了三样东西：
- Git核心，也就是真正干活的git命令引擎；
- Git Bash，一个模拟Linux终端的环境，内置了ls、grep、sed这些Unix命令，很多老开发在Windows上宁愿用Git Bash也不碰cmd；
- Git GUI，一个功能很简陋的图形界面，能用但不推荐作为主力。
安装时默认全装，如果只想要Git核心，后面两样可以不勾。但我的建议还是把Git Bash带上，后面处理换行符、脚本权限、SSH密钥这些事，它比Windows命令行省心得多。
1.2 下载地址怎么选，32位还是64位
首选官网git-scm.com/download/win，页面会自动识别系统弹出下载按钮。官网访问慢的话，可以用清华开源软件镜像站的git镜像目录，版本同步及时，直接下载Latest下的64位安装包就行。
选择哪个安装包，先看系统架构：右键"此电脑"→"属性"，在"系统类型"一栏能看到是64位还是32位。现在绝大多数机器都是64位，下载64-bit Git for Windows Setup即可。早年有人在这踩过坑，下成了32位，装完后发现路径变成C:\Program Files (x86)\Git，后面手动配PATH时对不上。
官网还提供Portable免安装版，适合不想写注册表、想放在U盘里带走的用户。但第一次使用，我还是建议老老实实装Setup版，因为右键菜单注册、环境变量配置、后续卸载清理都是安装器自动处理的，比手动折腾高效。
1.3 顺手把Git、GitHub、GitLab的关系理清
经常有新人问"装上Git是不是就有GitHub了"，这里必须说清楚：Git是你本地的版本控制工具，GitHub、GitLab以及国内代码托管平台是远程仓库托管服务。Git管理本地仓库版本，通过git push把提交推到远程平台，两者是配合关系。装完Git之后，即使不注册任何平台账号，你也可以在本地初始化仓库、提交版本、查看历史，只是在没有远程备份和协作能力。想真正用起来，下一步才需要去注册一个托管平台账号。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装向导逐项拆解：这几个选项千万别无脑Next
Git for Windows的安装向导是标准的Windows Installer流程，前半段一路Next没毛病。真正影响使用体验的关键选项集中在几页，我按顺序拆一遍。
2.1 组件选择和默认编辑器
- Additional icons：是否创建桌面图标，无所谓。
- Windows Explorer integration：强烈建议勾选。装完后文件夹和桌面右键菜单会出现Git Bash Here和Git GUI Here，以后想在哪敲命令就在哪右键进终端，省去手动cd的麻烦。
- Git LFS：建议勾选，这是大文件的扩展支持，后面需要提交设计稿、模型文件时不用再补装。
- Associate .git* configuration files、Associate .sh files to be run with Bash：按需勾选，默认状态就行。
进入Choosing the default editor used by Git这一页时，默认是Vim。很多新手第一次commit被带进Vim界面，不知道怎么保存退出，卡在那里手足无措。建议如果机器上装了VS Code或Notepad++，直接选成它们。如果已经装完并且默认Vim，后面也能补救：
bash复制git config --global core.editor "code --wait"
再提交时就会打开VS Code来写提交信息。
2.2 PATH环境变量：最容易出问题的一页
Adjusting your PATH environment这一页有三个选项：
- Git from the command line and also from 3rd-party software（推荐选这个）；
- Use Git and optional Unix tools from the Command Prompt；
- Only use Git from Git Bash。
第一个选项会把C:\Program Files\Git\cmd加进系统PATH，这样cmd、PowerShell、VS Code终端里都能直接用git。第二个会额外把Git自带的Unix工具混入Windows命令环境，覆盖掉系统自带的find、sort这些命令，经常引发一些奇怪兼容问题，不建议。第三个只在Git Bash里能用git，cmd一敲git就会提示"不是内部或外部命令"——很多人误以为安装失败，其实就是栽在这一步。
提示：选完PATH后，如果终端是安装前就打开的，里面的环境变量不会自动刷新。最稳妥的做法是全部关掉重开一个命令行窗口。
2.3 HTTPS后端、换行符、终端模拟器和分支名
Choosing HTTPS transport backend：默认的Use the OpenSSL library兼容性最好，GitHub和国内各大托管平台基本不挑。只有在企业内网、使用Windows域证书的环境，才需要考虑Use the native Windows Secure Channel library。
Line Ending Conversions：默认选项是Checkout Windows-style, commit Unix-style line endings，Windows用户保持默认即可。简单解释一下，Windows程序习惯用回车换行CRLF，Linux和Mac习惯用换行LF，默认模式让Git在检出文件时自动转成CRLF方便Windows工具打开，提交时再统一转回LF存进仓库，能省掉大量换行符冲突。
Use MinTTY：默认终端模拟器建议保持MinTTY。它比Windows自带控制台更顺滑，调整窗口大小、复制粘贴都更正常。如果在MinTTY里遇到粘贴不顺手，可以在Git Bash窗口标题栏右键→Options里重新配置。
默认分支名：现在GitHub新建仓库的默认分支叫main，安装器默认推荐也是main。老项目可能还是master，无所谓，真需要改时git branch -M main一条命令就能切换。
安装完成后，重新打开cmd或者PowerShell，输入git --version，能正常输出版本号，这一步就过了。
3. 装完别急着clone：全局配置和SSH密钥一次弄好
3.1 先告诉Git你是谁
安装成功后的第一件事，打开Git Bash，设置用户名和邮箱：
bash复制git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
如果不设置，Git会用系统主机名拼一个类似root@DESKTOP-ABC123的身份出来，这样的提交记录推到仓库后完全没法追溯责任人，代码评审和查历史时很尴尬。注意这里不是登录凭证，只是提交署名，让别人能认出是你就行，不要求和平台账号完全一致，但建议保持一致方便识别。
3.2 全局配置存在哪里，优先级怎么算
git config分三个层级：system整台机器生效，global当前用户生效，local当前仓库生效，优先级是local > global > system。--global参数会把配置写进用户主目录下的.gitconfig文件，在Git Bash里执行：
bash复制git config --list
能看到当前所有生效配置。如果某个公司的仓库要求单独的用户名，可以进对应仓库目录执行git config --local user.name "xxx"覆盖全局值，不影响其他项目。
3.3 两个建议手动加的配置
安装向导默认处理了大半问题，但有两项我强烈建议手动补一下：
bash复制git config --global core.autocrlf true
git config --global core.quotepath false
autocrlf可以是显式声明文本文件行尾自动转换，避免多出来一些奇怪警告。quotepath这个更关键，默认情况下git status、git log里出现中文文件名会显示成\xe6\xb5\x8b这种转义序列，看着特别痛苦。设成false之后，中文文件名和路径就能正常显示了，这也是很多新人在Windows上遇到的第一个"乱码"问题。
3.4 生成SSH密钥并配置到远程平台
本地仓库和GitHub、GitLab这些平台之间传输，SSH密钥比HTTPS每次输账号密码省事得多。在Git Bash里执行：
bash复制ssh-keygen -t ed25519 -C "你的邮箱"
连续回车几次就行，想更安全可以设置一个passphrase。生成的密钥默认存放在~/.ssh/id_ed25519（私钥）和~/.ssh/id_ed25519.pub（公钥）。用下面命令查看公钥内容：
bash复制cat ~/.ssh/id_ed25519.pub
复制输出的整串内容，去GitHub的Settings→SSH and GPG keys，或者GitLab、国内代码托管平台的SSH密钥设置页面新增即可。测试连通性用：
bash复制ssh -T git@github.com
第一次连接会提示确认主机指纹，输入yes回车，返回类似"Hi 用户名! You've successfully authenticated"的信息，就说明配置生效了。
3.5 本地仓库跑一次最小闭环
配置完这些，可以开一个小仓库把核心命令过一遍，验证环境是否真正正常：
bash复制mkdir git-demo && cd git-demo
git init
echo "# demo" > README.md
git status
git add README.md
git commit -m "first commit"
git log --oneline
能看到README.md的提交记录，就说明这一套环境完全可用。以后想实验任何git命令，都建议先开一个临时仓库，试错成本比在真实项目里低得多。
4. Windows上Git高频报错的排查记录
4.1 'git' 不是内部或外部命令
这是Windows上出现率最高的报错。80%的原因是安装时PATH选了Only use Git from Git Bash，或者终端没重新打开。
排查顺序：
- 打开cmd，输入where git（PowerShell用Get-Command git）。如果能找到路径但运行还报错，说明终端缓存了旧的PATH，全部关掉重开；
- 如果找不到，去C:\Program Files\Git\cmd确认git.exe是否存在；
- 存在就手动加环境变量：此电脑右键→属性→高级系统设置→环境变量→在Path中新增上面那个目录；
- 不存在就去控制面板卸载Git，重新装一次，PATH页面选第一项。
不需要为这个重启电脑，除非调用git的是系统服务这类不是在用户环境里启动的进程。
4.2 中文文件名和提交信息乱码
中文文件名在git status里显示成转义符，见第3.3节，执行git config --global core.quotepath false即可解决。提交信息乱码是另一回事，Windows的cmd默认代码页是GBK，执行：
bash复制chcp 65001
可以临时切成UTF-8。Git Bash没有这个问题。再配合两条全局配置：
bash复制git config --global i18n.commitEncoding utf-8
git config --global i18n.logOutputEncoding utf-8
大部分中文场景就正常了。
4.3 提交时刷屏的LF/CRLF警告
Git Bash里git add、git checkout时偶尔会刷出warning: LF will be replaced by CRLF或者相反，这是Git在按core.autocrlf配置做行尾转换的正常提示。Windows单机使用就保持true，不用理会。如果是跨平台团队协作，更稳妥的做法是在仓库根目录放一个.gitattributes文件，写上：
code复制* text=auto
让Git在提交时自动把文本文件统一转成LF存储，避免不同系统之间来回转换导致整个文件被标记为改动，Pull Request里出现一堆无意义的diff。
4.4 凭据管理器反复弹窗
用HTTPS克隆私有仓库时，Windows版Git默认走Git Credential Manager弹窗。如果密码换过或者之前输错，它会一直弹。问题源头常常在Windows凭据管理器里存了旧凭据：控制面板→用户帐户→凭据管理器→Windows凭据，找到和git服务器相关的条目删掉，下一次弹窗重新输入正确密码就恢复。
如果不太依赖弹窗，也可以换成store模式：
bash复制git config --global credential.helper store
Git会把凭据明文存在~/.git-credentials文件里。个人电脑上用可以，公司环境、共用机器不建议这么干，存在明文泄露风险。
4.5 SSH方式报Permission denied (publickey)
HTTPS正常，但SSH方式clone私库时报Permission denied，按顺序检查：
- ~/.ssh目录下有没有id_ed25519或id_rsa文件；
- 公钥内容是否已添加到远程平台的SSH Keys列表；
- 仓库地址是否写成了git@开头而不是https://开头。
确认无误后再用ssh -T git@github.com测试。如果是刚刚生成的密钥没有加载进SSH agent，也会有类似提示，执行：
bash复制eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
再测一次。
以下是几个高频错误的速查对照：
| 报错信息 | 核心原因 | 处理方式 |
|---|---|---|
| 'git' 不是内部或外部命令 | PATH未配置或终端未刷新 | 重开终端，或手动添加Git\cmd到PATH |
| LF will be replaced by CRLF | 行尾自动转换提示 | 保持core.autocrlf true，无需处理 |
| Permission denied (publickey) | SSH公钥未配置或地址格式错误 | 检查密钥、远程平台设置、URL格式 |
| 中文文件名显示为八进制转义符 | Git默认对非ASCII输出转义 | git config --global core.quotepath false |
5. 可选的增强操作：大文件、GUI和编辑器联动
5.1 Git LFS解决仓库膨胀问题
版本控制对文本文件很友好，但设计稿、模型文件、音视频这类二进制大文件一旦进仓库，clone和push会越来越慢，仓库体积很快膨胀。Git官方方案是Git LFS，用轻量指针文件替代大文件本体，大文件单独存到LFS服务器。安装时勾选了Git LFS就省得再单独装：
bash复制git lfs install
git lfs track "*.psd"
git add .gitattributes
之后*.psd文件自动走LFS。注意托管平台对LFS存储普遍有配额和收费，非必要时别把什么都挂进去。
5.2 小乌龟这类GUI工具怎么定位
TortoiseGit，也就是很多人叫的"小乌龟"，是Windows老用户中非常流行的右键菜单式GUI。装完之后无需打开终端，在文件夹里右键就能看到提交、更新、日志等菜单，文件图标的角标还能显示变更状态。对刚接触版本控制、不愿碰命令行的人来说，学习曲线确实更低。
但我的建议是工具可以装，命令行基础别丢。git status、git add、git commit、git log这四板斧先练熟，因为一旦遇到非标准问题，比如冲突解决、历史改写、自动化脚本，命令行是不可替代的。GUI适合日常操作，命令行适合定位问题，两者配合才是效率最高的状态。
5.3 让编辑器接管日常Git操作
VS Code内置了完整的源代码管理面板。Git装好并且PATH正常之后，直接打开项目文件夹，左侧的源代码管理图标里就能看到变更文件、暂存、提交、推送，高频操作基本可以用鼠标完成。JetBrains系列IDE（IntelliJ IDEA、PyCharm等）同样内置了Git支持。对日常开发来说，IDE集成比单独开Git Bash顺手很多。IDE偶尔识别不到Git，多半是启动时没读到最新的PATH，重启IDE或者在设置里手动指定git.exe路径就能解决。
从我带新人的实际经验来看，Windows下装Git，真正花时间的从来不是安装包本身，而是安装完之后对环境的理解：PATH是什么、行尾符为什么打架、SSH公钥和私钥怎么回事。把这些概念在一次安装过程中捋清楚，后面用Git就顺了。如果你已经一路Next装完并且撞上上面的某一个报错，不用急着卸载重装，照着第4节里对应的排查路径处理，大概率几行配置就救回来了。