Git现在已经不需要我再多介绍什么了，基本上只要碰代码，早晚都得跟它打交道。但有意思的是，我这几年在技术群和后台看到的求助消息里，十个新手最少有三四个不是被Git那堆命令劝退的，而是倒在了最不该倒下的地方——安装下载。
官网直连慢得离谱，下载到99%断了重来，装完了CMD里敲git报"不是内部或外部命令"，右键菜单找不到Git Bash……这些问题如果你都碰过，或者正被其中某一个卡住，今天这篇就是为你写的。我会从下载开始讲，把"国内网络下怎么把Git拿到手"这个老大难问题先解决掉，然后一步一步带你装完、配好环境变量、完成基础身份配置和SSH免密，最后再把新手高频遇到的几个坑单独拉出来排查一遍。目标很直接：跟着这篇文章走完，你的Git环境就能安稳落地，不用再去别处拼凑教程。
1. 为什么Git官网下载总是慢成PPT
1.1 慢的根源不在你的网速
先把结论放前面：Git下载慢，绝大多数情况下不是你宽带不行，也不是电脑出了毛病，而是Git for Windows的安装包托管在GitHub的Releases页面，服务器在海外，国内网络访问它需要跨越国际链路，高峰期丢包率高、带宽被限，速度自然就崩了。
我见过一个很典型的案例：同事下午四点从官网下载Git，速度稳定在2KB/s，按这个速度，一个将近60MB的安装包要下十几个小时，他看了一眼进度条直接放弃了。还有些人运气好一点，速度能到几十KB/s，但下载到一半连接断掉，浏览器又不会断点续传，只能从头再来，反复几次心态直接炸。
另外还有一个容易被忽略的点：浏览器直接从GitHub拉文件时，如果网络环境不稳定，中途断连的概率非常高，而且GitHub对单个连接的速度限制也比较严格，这不完全是运营商的问题，是跨网调度和服务器策略共同导致的结果。
1.2 先判断你的"慢"属于哪种情况
不是所有下载慢的解法都一样，动手之前先做个快速自检：
| 故障表现 | 大概率原因 | 解决方向 |
|---|---|---|
| 下载速度稳定在几KB/s | 国际链路限速 | 换国内镜像源 |
| 下载到一半就断，还得重新来 | 连接不稳定/被重置 | 换国内镜像源 |
| 页面能打开，但点下载按钮没反应 | CDN调度异常 | 换国内镜像源 |
| 浏览器下载慢，其他网站一切正常 | 对GitHub源站限速 | 换国内镜像源 |
看到这个表应该已经懂了，大多数情况下，唯一靠谱的解法就是换镜像源。网上有些教程给的方案绕来绕去，有门槛还不稳定，而且改完系统配置之后如果解析失效，反而更糟。镜像源的原理其实很简单——把GitHub服务器上的安装包同步到国内机房，你从国内服务器下载，走的全是内网级别的链路，速度自然不是一个量级，路径短、延迟低、断连概率小。
2. 镜像下载实操：一个链接解决下载难题
2.1 我用得最顺手的两个国内镜像源
目前我实际用下来最稳定的镜像源有两个。
第一个是清华大学开源软件镜像站，网址是 https://mirrors.tuna.tsinghua.edu.cn ，进去之后找git-for-windows相关目录，或者直接在站内搜索"git-for-windows"，就能看到按版本号排列的文件夹。清华镜像同步频率高，版本更新也比较及时，基本官网发新版本后几天内就能同步过来。
第二个是华为云镜像站，网址是 https://mirrors.huaweicloud.com/git-for-windows/ ，目录结构清晰，路径短，加载速度快，而且同样有完善的版本归档。如果你访问官网都被卡得不要不要的，这两个镜像站在国内网络下打开都是秒开级别。
两个站我都在不同时间段（包括晚高峰）测过速度，白天基本能顶着带宽上限跑，晚高峰也能维持在几MB/s，比官网的几KB/s强了几百上千倍。选哪个看你个人偏好，没有本质区别，哪个打开快就下哪个。
2.2 目录里那一堆文件，到底该下哪个
第一次打开镜像目录的人大概会有点蒙：版本文件夹里躺着一堆文件，名字都很接近。我拆开讲讲。
以进入 v2.45.2.windows.1 这个版本目录为例，忽略掉源码压缩包和补丁文件，你需要关注的核心文件其实就这么几个：
| 文件特征 | 适用场景 |
|---|---|
| Git-2.45.2-64-bit.exe | Windows 64位系统安装版，绝大多数人下这个 |
| Git-2.45.2-32-bit.exe | Windows 32位系统安装版，只有老机器才需要 |
| PortableGit-2.45.2-64-bit.7z.exe 或 .tar.bz2 | 便携绿色版，免安装解压即用，适合不想写注册表的场景 |
怎么确认自己的系统位数？Windows设置里打开"系统"页面查看"系统类型"，或者桌面右键"此电脑"→"属性"。现在市面上流通的电脑98%都是64位，所以默认选 -64-bit.exe 就行。
版本号怎么挑？我的建议是不用刻意追求新。Git的版本迭代非常频繁，镜像站首页显示的最新版本号可能比你现在看到的还要高一级，但稳定版和最新版在功能上差距很小。挑一个发布时间超过一周的版本，等社区反馈稳定了再装更稳妥，你要的是干活不添乱，不是抢先用新功能。
2.3 下载过程中的两个小提醒
第一，尽量用浏览器自带的下载功能，不要为了"提速"专门去折腾那些第三方下载加速工具。Git安装包本身不算大，镜像源速度已经够快了，完全没必要让下载器介入。反而有些下载工具为了加速会搞P2P共享，容易触发杀毒软件误报，到时候装的时候还要多一步判断，纯粹给自己找麻烦。
第二，下载完成后先看一眼文件大小再双击。Git for Windows的64位安装包，体量在60MB上下浮动。如果你下下来的文件只有几MB，那几乎可以肯定下载不完整，或者页面跳转出了幺蛾子，这种情况别硬装，直接删掉重下，免得后面报一个莫名其妙的错误浪费时间。
3. 安装向导逐项过一遍：有取舍，有理由
安装包到手，双击运行（如果UAC弹窗就点"是"）。接下来是一长串安装向导，很多人习惯闭着眼睛一路"Next"，但我劝你还是花三分钟把每个选项过一遍。这些选项不是摆设，选错了后面会以各种奇怪的方式找你麻烦。
3.1 安装路径和组件选择：空间与右键菜单的学问
第一个实质性的选择是安装路径，默认 C:\Program Files\Git。C盘空间充足就保持默认，想换个盘放也行。但注意路径里不要出现中文和空格，比如 D:\Program Files\Git 没问题，D:\软件\Git 这种就别用了，Git内置的Shell工具对中文路径支持不算好，你现在图省事，后面可能会在某个莫名其妙的时刻收获一个编码错误。
下一页是Select Components，逐项说：
- Additional icons（附加图标）：桌面快捷方式，可勾可不勾，没啥影响。
- Windows Explorer integration（Windows资源管理器集成）：强烈建议勾选。这一项会给你右键菜单加上"Git Bash Here"和"Git GUI Here"，以后在任意文件夹里右键就能直接打开Git Bash，省去了每次手动cd到项目目录的麻烦，这是日常使用频率最高的入口。
- Git Bash Profile for Windows Terminal：建议勾选。Windows 10/11自带终端，勾完之后新建标签页里会多出Git Bash选项，切换很方便。
- Git Credential Manager：强烈建议勾选。它负责账号密码凭据管理，后面推送到远程仓库时第一次输入密码会被Windows记录下来，之后就不用反复输入了。
- 符号链接等高级选项：默认别动，除非你明确知道它是干嘛的。
3.2 默认编辑器：别让Vim成为你的第一个拦路虎
到Select Default Editor这一步，默认选的是Vim。Vim在程序员圈子里确实很神，但它对新手极其不友好，尤其是你只是想提交一次代码、写两行提交信息的时候，git commit 弹出一个Vim窗口，光标停在最下面闪烁，你连怎么进入输入模式都不知道，更别说保存退出了。很多人第一次用Git就卡在这里，还以为是自己代码写错了。
我的建议非常直接：电脑上装了VS Code，就在下拉框里选 Use Visual Studio Code as Git's default editor。没装的话，顺手装一个也不亏。选完之后，每次git commit会弹出VS Code窗口，你像编辑普通文件一样写提交信息，关闭标签页就完成了。体验完全是另一个档次。这一步不是必须，但绝对是新手友好度提升最大的一步。
3.3 PATH三选一：这是安装全程最关键的一步
Adjusting your PATH environment这个界面，三个单选选项，我见过无数人在这一步选错：
- Use Git from Git Bash only —— Git只能在Git Bash窗口里用，在CMD和PowerShell里敲git会提示找不到命令。不推荐。
- Git from the command line and also from 3rd-party software —— Git在Git Bash、CMD、PowerShell、VS Code终端里都能直接用。强烈推荐，绝大多数人选这个。
- Use Git and optional Unix tools from the Command Prompt —— 除了Git之外还会把一系列Unix小工具装进PATH，比如find、sort等命令会被Git自带的版本覆盖。不推荐，因为Windows本身就有同名命令，两边一起出现在PATH里，行为冲突排查起来极其麻烦。
选第二项，不用犹豫。选完之后安装程序会把Git的cmd目录写进系统PATH，这就是为什么装完理论上能在CMD里直接用git的原因。
3.4 HTTPS后端、行尾转换和终端选项：三个容易忽略的隐形选择
接下来的几个界面，很多人都是随手点默认，我不拦着，但你起码要知道影响是什么。
Choosing the HTTPS transport backend里两项：Use the OpenSSL library 和 Use the native Windows Secure Channel library。前者是Git自带的安全加密库，跨平台一致性好；后者调用Windows系统自带证书体系，在公司网络环境或特殊证书环境下更有优势。普通使用者保持默认的OpenSSL就好，不用改。
Line ending conversions是三选一，这是老生常谈的换行符问题。Linux用\n，Windows用\r\n，Git当初是Linux下开发的，如果不管换行符，拉下来的文本文件在Windows上可能显示成一行，或者你没改任何内容、Git却提示整个文件都变了。推荐选第一项 Checkout Windows-style, commit Unix-style line endings，Git会在拉取代码时自动转成Windows的\r\n，提交时转回Unix的\n，两边都不得罪，这是最主流、最不容易踩坑的方案。
Choose a terminal emulator for Git Bash：默认是Use MinTTY，保持默认即可。MinTTY类似Unix终端，复制粘贴用鼠标选中即复制、右键即粘贴，用习惯了回不去。
后面的Configure extra options：Enable file system caching建议勾选，能提升Git在Windows上的性能。Enable symbolic links不要勾，Windows上启用符号链接需要管理员权限，日常用起来很麻烦。最后是实验性选项页面，直接跳过。
全部确认完后点Install，剩下就是等安装进度条走完。整个过程大概一两分钟，比下载时间短得多。
4. 落地的临门一脚：环境变量与验证命令
4.1 装完CMD报"git不是内部或外部命令"，为什么
这是安装后出现频率最高的报错，没有之一。明明安装界面没有报错，打开CMD敲 git --version 却提示"不是内部或外部命令"。
原因通常是这几种：
- 安装程序确实写了环境变量，但你之前已经打开的CMD窗口还停留在旧环境里，不会自动刷新。解决办法很简单：把CMD或PowerShell全部关掉，重新开一个。
- 部分安全软件会拦截安装程序修改环境变量的动作，然后悄无声息地把这次变更拦下来。
- 安装时选了自定义路径，PATH写入在某些特殊情况下没有正确生效。
无论哪种，手动配置环境变量都是最彻底、最一劳永逸的解法。别嫌麻烦，这一步弄好了，后面十年都省心。
4.2 手动配置环境变量的完整流程
先确认Git的安装目录，默认是 C:\Program Files\Git，或者你自定义的路径。打开这个目录，能看到里面有三个核心子目录：cmd、bin、usr。环境变量需要指向的是cmd目录，因为git.exe就躺在里面。
具体操作步骤：
- Windows搜索栏输入"编辑系统环境变量"，打开"系统属性"窗口，点右下角"环境变量"。
- 在"系统变量"区域点"新建"，变量名填
GIT_HOME，变量值填Git安装根目录，比如D:\Program Files\Git，确定。 - 在系统变量里找到
Path，双击打开，点"新建"，添加一行%GIT_HOME%\cmd，确定。 - 一路点确定，把设置窗口全部关掉。
这里设置GIT_HOME再引用它，而不是直接把完整路径写进Path，是很多老工程师的习惯。好处是以后Git版本升级或者你手动改了安装目录，只需要改GIT_HOME这一个变量，Path里引用它的位置不用动，维护成本极低。
4.3 三个命令确认装好了
配置完成，重新打开一个新的CMD或PowerShell窗口（强调：一定新开，旧窗口读不到最新环境变量），依次验证：
git --version输出 git version 2.45.2.windows.1 这样的版本号，说明Git本体安装成功。
where git输出 C:\Program Files\Git\cmd\git.exe 或者你的自定义路径，说明PATH生效，系统能找到git命令。
git config --list如果提示没有配置或No such file，说明目前还没有任何配置项，这是正常的，下一步就去配。
5. 开工前的身份配置：user.name、user.email和SSH密钥
5.1 user.name和user.email，为什么一上来就要配
Git每次提交都会记录作者姓名和邮箱，这两个信息来自用户配置。你不主动配置的话，有的场景下Git会从系统用户名拼一个默认身份，有的场景会直接报错让你指定，还有的场景会在提交时提示"Please tell me who you are"。
更糟糕的是，如果你没配置就提交了，代码记录里的作者信息可能是一串看不懂的乱码或者直接缺失，你的工作量会被完整记录下来，但没人知道那是你干的。在GitHub个人主页的贡献图上对应格子也显示不出来。所以安装完成后第一件事，配置全局身份：
git config --global user.name "你的昵称" git config --global user.email "你的邮箱"--global参数表示这台电脑所有Git仓库默认都用这个身份。如果将来有某个项目想用不同身份，在项目目录下不带--global再执行一次同样的命令就行，项目级配置会覆盖全局配置。
输完用 git config --list 检查，能看到 user.name 和 user.email 两行，说明配置生效了。
5.2 SSH密钥生成：一张表分清公钥和私钥
要把代码推到远程仓库（GitHub、GitLab、Gitee都行），最方便的认证方式就是SSH密钥。配置一次，以后操作远程仓库再也不用输密码。
打开Git Bash，输入：
ssh-keygen -t ed25519 -C "你的邮箱"如果系统提示不支持ed25519算法（极少见，一般发生在老版本上），换成ssh-keygen -t rsa -b 4096 -C "你的邮箱"就行。-C参数只是给密钥加备注，写邮箱是为了以后多把密钥时方便区分。
回车后会询问密钥保存路径，默认是 C:\Users\你的用户名.ssh\id_ed25519，直接回车用默认即可。接下来要求设置passphrase密码短语，可以留空直接回车，也可以设一个。留空的密钥用起来完全免密，但风险是如果别人拿到你的私钥文件就能直接访问你的仓库；设了密码短语的话，第一次使用密钥时还要输一次，安全性和便利性的平衡。我的建议是：独立个人电脑留空可以，公用电脑一定设。
密钥生成完后，你会得到两个文件：
| 文件名 | 性质 | 安全级别 |
|---|---|---|
| id_ed25519 | 私钥 | 只能留在本机，泄露等于把仓库钥匙交给别人 |
| id_ed25519.pub | 公钥 | 可以公开，贴到代码托管平台账户上 |
查看公钥内容：
cat ~/.ssh/id_ed25519.pub复制输出整行（以ssh-ed25519开头，邮箱结尾），登录你的代码托管平台，找到"设置"→"SSH Keys"或"SSH公钥"页面，粘贴保存，就完成了。
5.3 验证SSH连通性，别等到推送时才发现问题
以GitHub为例，在Git Bash里执行：
ssh -T git@github.com第一次连接会询问是否信任主机，输入yes回车。如果看到Hi 你的用户名! You've successfully authenticated这样的输出，就说明SSH配置成功了。Gitee用户执行ssh -T git@gitee.com，看到"成功验证"字样即可。
这一步务必先验证通过再说。否则后面clone SSH协议的仓库时报权限错误，你还要回头排查半天。
6. 装完之后的高频报错排查手记
最后写几个我实际帮人排查时遇到最多的报错，按频率从高到低排。
6.1 安装卡在中间，进度条不动
Git安装程序卡住，多见于安全软件后台拦截弹窗没有正常显示的情况。检查顺序：先看安全软件有没有拦截提示，有就点允许或临时退出，再重试；再看安装目录所在磁盘剩余空间，空间不足也会导致进度条假死；最后以管理员身份右键运行安装程序，排除权限问题。Win7老系统如果遇到兼容性问题，可以右键安装包属性里把兼容模式调成Windows 7再运行。
6.2 右键没有"Git Bash Here"
安装时没勾选Windows Explorer integration，或者系统里装过其他右键菜单管理工具把它禁用了。前者需要重新运行安装程序，在组件选择界面勾选对应项修改；后者去右键菜单管理工具里把Git Bash Here启用。这种情况重装一次就好，不用卸载，直接覆盖安装选组件即可。
6.3 克隆仓库报SSL certificate problem
报错内容类似unable to get local issuer certificate。通常两种原因：一是本地系统证书链不完整，更新系统根证书一般能解决；二是公司内网对HTTPS流量做了证书替换（很多企业网关的常规操作），导致Git不信任当前证书。第二种情况推荐在安装Git时选择"Use the native Windows Secure Channel library"后端，让Git使用Windows系统证书库，兼容性会好很多。如果你赶时间，可以临时执行git config --global http.sslVerify false绕过验证，但这条命令只在排除问题时用，平时别开着，否则HTTPS传输等于没有安全校验。
6.4 每次推送都要密码，说好的免密呢
最常见的坑是：远程仓库地址仍然以https开头。HTTPS协议推送到远程时本来就要认证，凭据管理器虽然能记住，但没有正确配置的情况下每次还是会重新要密码。两个解决办法：一是安装时确认勾选Git Credential Manager，让Windows凭据管理器接管密码；二是直接把远程地址改成SSH地址，执行git remote set-url origin git@github.com:用户名/仓库名.git，然后用SSH方式推送，一次配置永久免密。第二个方案我推荐，因为SSH方式不依赖Windows凭据体系，换电脑迁移也更干净。
6.5 Git Bash中文乱码与文件名显示异常
Git对非ASCII字符默认做了转义处理，仓库里的中文文件名在git status输出时会变成一串反斜杠加数字的编码。执行一下：
git config --global core.quotepath false之后中文文件名就能正常显示了。如果Git Bash终端本身的输出乱码，可能是字体和字符编码的问题，在Git Bash窗口标题栏右键，进入Options，把文本编码调整为UTF-8，基本上能解决大部分显示问题。
最后再分享一个我自己踩过的小坑：装完Git之后顺手把默认分支名也统一一下，执行git config --global init.defaultBranch main。老版本Git初始仓库的默认分支叫master，新版本叫main，提前把默认分支名设成main，以后你在终端里跑git init出来的仓库，分支名就不会一会儿master一会儿main的，手上多个项目也不容易搞混。这一步虽然不起眼，但属于那种"提前做了没感觉，没做早晚被坑"的配置。
