1. 搞技术的第一步卡在了下载Git上说个挺常见的场景刚换电脑、刚入职新公司或者第一次在Windows环境里配开发工具打开浏览器去Git官网下载Git结果进度条像是被按了暂停键几MB的安装包跑了半个小时还没完最后直接报错下载失败。你去群里问得到的回复多半是用镜像啊换个源啊可到底去哪儿找镜像、哪个镜像靠谱、装完之后怎么配没人给你讲全。这篇博文要解决的就是这一整条链路的问题。先搞清楚为什么Git下载会慢到让人怀疑人生再把手头可用的下载渠道挨个盘一遍从官方源到国内镜像站把各自适合的场景和注意事项说透。接着是完整的Git安装指引Windows、Linux、macOS三条路都会覆盖装完之后该做的初始配置和SSH密钥生成包括日常clone仓库时常见的加速思路一并在后面展开。最后是我自己踩过的坑和整理出来的排查速查表方便你遇到问题的时候能快速定位。内容不搞虚的全是实际操作层面的事。不管你是刚入门想在自己电脑上装个Git还是要在服务器上部署环境哪怕只是被下载速度和安装选项折磨过的老手这篇都值得花几分钟看完。2. 为什么Git下载这么慢以及现有的下载渠道到底有哪些2.1 先搞清楚慢在哪不是网速问题是链路问题很多人下载Git卡住的第一反应是我网速不行但实际上下载速度取决于你到服务器之间的网络路径质量。Git官方安装包部署在国外的服务器上国内用户访问时数据要跨越大半条地球的链路再加上高峰期丢包、限速等因素速度慢是很正常的。这跟你的宽带大小没有直接关系你就算拉了千兆光纤瓶颈也不在你这一端。这就解释了为什么有人用下载工具多线程下载也没用因为单线程慢还能靠多线程提速可如果是整个链路响应迟钝多线程照样跑不动。真正有效的办法只有一个换一条离你近、链路质量好的下载通道也就是国内镜像。2.2 官方下载渠道怎么访问、怎么选版本Git官方下载页面的地址是git-scm.com/downloads这个页面会根据你的操作系统自动推荐对应版本。页面结构比较简单但有几个细节容易看花眼Windows用户要分清32位和64位安装包现在绝大多数电脑都是64位系统但如果你不确定自己的系统位数可以先按Win Pause键打开系统信息看一眼。选错位数虽然也能装但装出来的环境有些第三方工具调用时会报兼容性错误没必要踩这个坑。官方网站同时提供便携版Portable和标准安装版Standalone Installer两种文件。便携版不需要安装解压就能用适合做U盘工具或者临时环境标准版会写入系统注册表和右键菜单适合长期开发使用。绝大多数人应该选标准版我见过有新手下载了便携版后找不到右键菜单入口绕了不少弯路。另外提醒一句官网上的Latest source release下面是源码包不是安装包。源码包需要自己编译安装新手不要碰这个直接往下找到Windows或者macOS对应的二进制安装包下载即可。2.3 国内镜像源盘点哪个能用、怎么选国内镜像站是解决下载慢最常见、也最稳妥的方案。几个主流镜像源各有特点我按推荐程度排个序说明。清华大学开源软件镜像站mirrors.tuna.tsinghua.edu.cn是我用得最多的一个。它的Git仓库路径清晰更新及时基本当天同步官方版本而且带宽非常充足下载速度基本能跑满你的宽带。访问方式是在镜像站首页搜索git进入git-for-windows目录后下载对应版本。阿里云镜像站mirrors.aliyun.com同样有Git的Windows构建版本速度也很稳。它的目录结构比清华稍微隐蔽一点需要找到git-for-windows这个路径。阿里云的特点是国内节点多不同地区的访问速度差异不大。华为云镜像站mirrors.huaweicloud.com也提供Git相关资源不过它更侧重Linux发行版和容器镜像Git for Windows的更新速度有时候会慢一些不建议作为首选但可以作为备选。还有一点值得注意GitHub官方仓库的Releases页面里也能找到Git的安装包但GitHub本身访问就不稳定下载速度同样没保障不建议从这条路径入手。部分企业内网也有自己的软件仓库如果是公司电脑优先问一下运维同事有没有内网源那个速度才是真的快。2.4 用表格对比一下几个下载渠道渠道访问速度国内更新及时性适用场景Git官网git-scm.com慢容易失败官方最新海外用户或网络条件较好的场景清华TUNA镜像极快基本当天同步国内首选个人和服务器均适用阿里云镜像极快同步及时国内备选多地区速度均衡华为云镜像快偶尔延迟备选或华为云服务器内网使用GitHub Releases不稳定官方最新不推荐作为下载Git安装包的常规路径3. Git安装全流程实操Windows、Linux、macOS一次讲透3.1 Windows环境下的Git安装步骤从镜像站下载好的exe文件一般叫Git-2.x.x.x-64-bit.exe这种格式。双击运行后安装向导会引导你一路点Next但有几个关键选项如果你直接默认过去后面使用的时候会折腾半天。第一个关键选项出现在Select Components页面。这一页有很多复选框建议勾选Additional icons下的On the Desktop创建桌面图标方便快速打开。更关键的是Windows Explorer integration下面的两个选项一个是Git Bash Here一个是Git GUI Here这两个一定要勾上它们会在鼠标右键菜单里加入Git Bash和Git GUI入口日常使用会方便很多。尤其是Git Bash它是Windows下最常用到的命令行环境如果没有在右键菜单里添加入口之后每次想打开都要手动找到安装目录麻烦不说还容易让新手误以为Git没装好。第二个关键选项在Choosing the default editor页面。这里要选择Git默认使用的文本编辑器。默认是Vim但Vim对新手极不友好打开配置文件后不知道怎么编辑和退出我见过不少人在这一步被劝退。建议选择Use Notepad或者Use Visual Studio Code前提是这些编辑器已经提前装好。如果你暂时没装任何第三方编辑器也先选Vim等后面的操作需要编辑文件时再说不影响Git本身的正常工作。第三个关键选项是Adjusting your PATH environment这一页。这里必须选择中间项Git from the command line and also from 3rd-party software。如果选了第一项只从Git Bash里使用Git那么在正常的CMD或PowerShell窗口里输入git命令会提示找不到选了第三项虽然功能不受影响但会把一些Unix命令也带到系统环境里容易和Windows本身的命令产生冲突不是必要需求的话不建议选。后面的几个页面包括换行符处理方式Checkout Windows-style, commit Unix-style line endings、远程连接协议Use the OpenSSL library、以及终端模拟器选择保持默认即可这些配置对大部分日常场景都是最优解。全部点完后开始安装速度很快几分钟内完成。3.2 安装完成后的验证和环境确认安装结束后打开任意一个CMD窗口或者PowerShell窗口输入git --version如果返回类似git version 2.45.1.windows.1的信息说明安装成功。这一步一定要做我遇到过很多人装完以为成功了结果打开命令行输入git提示不是内部或外部命令原因多半是前面PATH那一步选错了选项或者是安装完没有重新打开终端窗口。环境变量是在安装过程中写入系统的已经打开的终端不会自动刷新所以在验证之前务必把已打开的CMD、PowerShell、VS Code等程序全部关闭再重新打开。再验证一下Git Bash能否正常启动。在桌面或文件夹空白处点右键菜单里应该出现Git Bash Here点击后能弹出类似Linux终端的黑色窗口。Git Bash的窗口里可以执行ls、cd、pwd这类Linux命令这些命令在Windows原生CMD里是跑不了的这也代表着Git自带的模拟环境已经正常工作。3.3 Linux环境下的Git安装命令Linux发行版安装Git基本靠包管理器一行命令搞定但需要注意区分不同发行版的包管理器。Debian、Ubuntu系列使用aptsudo apt update sudo apt install git -yCentOS、RHEL、Fedora这些Red Hat系新版本用dnf老版本用yumsudo dnf install git -y # 或者 sudo yum install git -yArch Linux使用pacmansudo pacman -S git这些包管理器安装的Git版本可能不是最新的但对绝大多数开发场景足够用了。如果你确实需要安装更新的Git版本有两个思路一个是添加官方维护的第三方软件源比如针对Ubuntu的git-core/ppa另一个是下载源码手动编译。手动编译的流程大致是到Git官网或镜像站下载源码包解压后依次执行make configure、./configure --prefix/usr/local、make all、sudo make install。这里要注意编译之前必须确保系统已经安装了gcc、make、autoconf等编译工具链否则会在configure阶段报一堆缺失依赖的错误。不是刚需的话我还是建议直接用包管理器省时省力。3.4 macOS环境下的Git安装方式macOS没有自带Git至少新版本系统是这样的安装方式主要有三种。第一种用Homebrew安装这是macOS上最主流的包管理器。执行brew install git如果还没装Homebrew安装Homebrew本身又是一道坎这里不再展开。第二种是下载图形化安装器即在Git官网的macOS下载页面找到对应版本下载dmg文件后双击安装。这种方式的安装过程和Windows类似一路继续、安装、完成同样别忘了在终端里验证git --version。第三种是Apple官方提供的Command Line Tools它是独立于Xcode的一套命令行开发工具里面也包含Git。安装命令是xcode-select --install这种方式的好处是省去了单独装Git的步骤坏处是版本更新依赖Apple的系统更新通常版本会偏旧对Git新特性有依赖的项目可能会遇到兼容问题。我的建议是如果你的主力环境是macOS做开发优先用Homebrew安装版本新、更新方便。3.5 安装完成后的第一件事配置用户名和邮箱装好Git之后第一件该做的事不是急着clone代码而是配置你的身份信息。Git每次提交代码的时候都会记录提交者的名字和邮箱如果没配置提交时要么报错要么提交记录里的显示名是乱起八糟的默认值。打开Git BashWindows或终端Linux/macOS依次执行git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com--global参数表示全局生效也就是说这台电脑上所有仓库的提交都会使用这个身份信息。如果你想针对某个仓库单独设置身份可以在仓库目录下执行不带--global的配置命令优先级会覆盖全局配置。验证配置是否生效执行git config --global --list会输出user.name和user.email两行信息。这一步配置好了后续提交代码才不会遇到各种身份相关的报错。4. 安装只是开始基础配置和SSH密钥这里讲透4.1 为什么SSH密钥几乎是必配项配置好用户名和邮箱之后下一个高频操作就是和远程仓库建立连接。现在主流的代码托管平台不管是国内还是国外的都提供了HTTPS和SSH两种远程连接协议。HTTPS协议的使用最简单clone的时候直接填仓库地址推送代码的时候输入账号密码或者个人访问令牌Personal Access Token就能操作。但坑也在这里GitHub早就取消了账号密码的直接认证现在用HTTPS必须用token而token的权限管理如果不熟练很容易遇到权限不足的报错。SSH协议则不需要每次操作都输入账号密码。它通过一对密钥完成身份验证私钥留在本地公钥放到代码托管平台的后台。这种方式的体验要好得多配置一次之后就畅通无阻。所以我强烈建议所有人都配置SSH密钥这也是代码托管平台官方文档里推荐的连接方式。4.2 SSH密钥生成实操从生成到部署在Git BashWindows或终端Linux/macOS里执行ssh-keygen -t rsa -b 4096 -C 你的邮箱example.com这里的-t rsa指定密钥类型-b 4096指定位数位数越大越安全4096是当前主流选择-C后面的内容通常写你的邮箱它会作为一个备注信息写入公钥文件中方便识别这枚密钥属于谁。执行后系统会问你要把密钥保存在哪里默认路径是用户目录下的.ssh文件夹直接回车使用默认路径即可。接下来会提示设置一个口令passphrase这相当于给私钥加一层保护每次使用私钥的时候需要输入口令。如果你不想每次操作都输口令可以直接回车跳过安全性稍微低一点但日常开发便利性更高。我个人的习惯是本地开发环境不设口令公司电脑和服务器上设置口令折中处理。生成完成后在.ssh目录下会多出两个文件。id_rsa是私钥绝对不能泄露不要发给任何人也不要复制到其他地方id_rsa.pub是公钥是可以公开的内容我们需要把公钥内容拿到代码托管平台上去配置。查看公钥内容的命令是cat ~/.ssh/id_rsa.pubWindows的Git Bash里也可以执行同样的命令它会输出一串以ssh-rsa开头、以你刚才填写的邮箱结尾的文本。把这整段内容复制下来。接下来登录你的代码托管平台进入设置页面找到SSH Keys或SSH公钥管理入口。以常见的GitHub为例路径是Settings - SSH and GPG keys - New SSH key。标题随意填写比如my-laptopKey那一栏粘贴刚才复制的公钥内容点保存即可。国内平台的操作路径大同小异一般在个人设置里都能找到类似入口。验证是否配置成功可以在终端执行ssh -T gitgithub.com如果看到类似Hi yourname! Youve successfully authenticated的提示说明密钥已经生效本地和远程仓库的连接已经打通。4.3 日常clone加速的替代思路镜像站点的使用配置好密钥之后就是日常的clone和push操作了。这里再提一个跟前面下载安装类似的场景就是clone位于国外托管平台上的开源项目时速度同样可能会很慢甚至超时失败。这是因为代码托管平台本身的服务器在境外网络链路问题在clone阶段会再次出现。解决的思路和下载Git安装包是相通的通过一个国内的镜像站点中转。现在有一些第三方平台提供了GitHub仓库的镜像服务访问方式通常是在原仓库地址前面拼接镜像站域名。举个例子你要clone的仓库地址是git clone https://github.com/user/repo.git用镜像站的地址来clone就是把前面的一段替换成镜像域名后面的路径保持原样。这样数据会从国内节点传输速度明显更快。这里必须强调一个安全原则第三方镜像站只能用来下载公开仓库的代码绝对不能用来操作你的私有项目也不要在镜像站页面里输入任何账号密码和token信息。自己公司的核心代码还是通过正常配置的远程仓库地址来操作。镜像站是解决访问速度问题的临时手段不是改写的正式工作流。如果你有多个上游仓库要切换可以在已经clone好的本地仓库里修改远程地址。查看当前远程地址用git remote -v修改远程地址用git remote set-url origin 新地址这样就不用重新clone一遍代码了直接在原有基础上切换源省流量也省时间。5. 高频问题排查下载、安装、配置阶段的坑我替你踩过了5.1 下载阶段进度条不动、下载中断怎么处理下载Git安装包时最常见的两个问题是卡在某个百分比不动和下载到一半直接失败。卡住的情况优先考虑浏览器下载是否被安全软件拦截。Windows自带的Defender或者是第三方杀毒软件有时候会把从互联网下载的exe文件当成潜在威胁导致下载中断。解决方法是临时关闭实时防护或者把下载目录加入白名单。下载多次失败的情况下不要死磕同一个渠道。我实测过的经验是官网下载失败换清华镜像基本都能解决清华镜像偶尔因为高峰期带宽紧张换个阿里云镜像可能反而更快。多准备几个下载源哪个能用用哪个。还有一种情况是下载速度看着很快但安装包校验不过提示文件损坏。这种情况多半是下载过程中数据出错要么重新下载要么换个渠道下载。下载完成后可以比较一下文件大小是否和页面上标注的一致对不上的话果断删掉重新下载。5.2 安装阶段Windows安装卡住、报错的处理Windows上安装Git卡住的情况虽然不多但一旦出现就很让人头疼。最常见的原因是安装路径有问题。如果安装向导的路径指向某个带中文的目录名或者目录权限受限安装进程会一直转圈或者报Access denied。建议把安装路径直接设置到C:\Program Files\Git保持默认不动不要自作聪明改到其他奇怪的目录。另一个容易让人误判的情况是安装到最后一步的时候窗口一直停在Installation completed不消失。这个其实是安装向导在等待用户点击Finish按钮不是卡死了直接点掉就行。如果是企业电脑还可能遇到没有管理员权限导致安装无法继续的情况。Git安装包在写入系统目录时需要管理员权限普通域账号如果没被授予安装权限安装向导会在某个阶段弹出UAC提示框这时候不要点取消要选择是来授权。5.3 安装成功后git命令找不到怎么办明明安装成功了打开CMD输入git --version却提示找不到命令这种情况十有八九是两种原因。第一种是安装时PATH那一步选错了选项。解决办法是重新运行一遍安装程序选择Modify模式在PATH配置那一页改成Git from the command line and also from 3rd-party software。这样系统环境变量会被重新写入然后重启终端就能生效。第二种是安装时没有勾选任何PATH相关选项这种情况不但需要重新安装修改配置还可能需要在系统环境变量里手动添加Git的路径。操作步骤是右键我的电脑 - 属性 - 高级系统设置 - 环境变量在系统变量里找到Path编辑并新增Git的bin目录路径通常是C:\Program Files\Git\bin。注意要使用完整路径不要用相对路径。5.4 配置阶段用户名邮箱和SSH密钥的常见坑用户名邮箱配置了却不生效这种情况通常发生在多仓库环境下。git config --global是全局配置但如果你在某个仓库目录下执行过不带--global的配置仓库级别的配置会覆盖全局配置。排查方法是进入仓库目录执行git config --list这会列出当前仓库使用的所有配置项从上往下的顺序中靠后面的配置会覆盖前面的同名配置。看到多个user.name或user.email时注意分辨哪个是全局的、哪个是仓库级的。SSH密钥配置完成后连接仍然失败优先排查密钥指纹是否匹配。执行ssh -T gitgithub.com如果返回Permission denied (publickey)说明服务器没有识别你的公钥重新检查公钥是否完整地粘贴到了后台以及粘贴时是否不小心多复制了空格或换行。5.5 问题速查表现象原因解决方案官网下载极慢或失败访问境外服务器链路差改用清华、阿里云等国内镜像站安装包下载后提示损坏下载过程中数据出错换渠道重新下载核对文件大小安装向导卡在启动阶段安装路径含中文或权限不足使用默认安装路径确认管理员权限git命令提示找不到PATH配置错误或未重开终端重装并选择正确PATH选项或手动加环境变量提交代码报身份错误未配置user.name和user.email执行git config --global配置SSH连接Permission denied公钥未正确配置到平台重新粘贴公钥验证密钥指纹clone国外仓库慢原仓库服务器链路差使用镜像站点地址clone公开仓库6. 我的个人建议按这个顺序来少走弯路这篇文章写到这里核心的内容基本都覆盖了。最后分享一点我自己在实际操作中总结出来的经验也算是一个推荐的操作顺序。第一次在电脑上安装Git的时候不要一上来就去官网点下载按钮先想清楚自己的网络环境和电脑配置。我的建议是Windows用户直接打开清华镜像站找到最新版的64位安装包下载速度基本是秒完装的时候老老实实用默认路径注意把PATH那个选项选对装完先验证git --version然后立刻把用户名和邮箱配上再顺手生成一份SSH密钥、把公钥加到代码托管平台上。这一套流程走完你的Git环境就算真正能用了后面再开始clone代码体验会非常顺畅。等熟悉了基础操作之后再把git remote、分支切换、冲突解决这些日常命令练熟。还有一个小技巧如果在clone某些项目的时候发现仓库太大、历史记录很多导致clone很慢可以先用git clone --depth 1做浅克隆只拉最新一次提交需要完整历史的时候再执行git fetch --unshallow来补充实测在仓库很大的场景下能省不少时间。工具链这种东西配置好了一次受益很久所以初期的这些安装配置步骤真的值得认真对待。 
长河君 · 2026/9/19 19:50:58 · 阅读 1.2k Git下载慢怎么办？国内镜像源与全平台安装配置实战指南
1. 搞技术的第一步卡在了下载Git上说个挺常见的场景刚换电脑、刚入职新公司或者第一次在Windows环境里配开发工具打开浏览器去Git官网下载Git结果进度条像是被按了暂停键几MB的安装包跑了半个小时还没完最后直接报错下载失败。你去群里问得到的回复多半是用镜像啊换个源啊可到底去哪儿找镜像、哪个镜像靠谱、装完之后怎么配没人给你讲全。这篇博文要解决的就是这一整条链路的问题。先搞清楚为什么Git下载会慢到让人怀疑人生再把手头可用的下载渠道挨个盘一遍从官方源到国内镜像站把各自适合的场景和注意事项说透。接着是完整的Git安装指引Windows、Linux、macOS三条路都会覆盖装完之后该做的初始配置和SSH密钥生成包括日常clone仓库时常见的加速思路一并在后面展开。最后是我自己踩过的坑和整理出来的排查速查表方便你遇到问题的时候能快速定位。内容不搞虚的全是实际操作层面的事。不管你是刚入门想在自己电脑上装个Git还是要在服务器上部署环境哪怕只是被下载速度和安装选项折磨过的老手这篇都值得花几分钟看完。2. 为什么Git下载这么慢以及现有的下载渠道到底有哪些2.1 先搞清楚慢在哪不是网速问题是链路问题很多人下载Git卡住的第一反应是我网速不行但实际上下载速度取决于你到服务器之间的网络路径质量。Git官方安装包部署在国外的服务器上国内用户访问时数据要跨越大半条地球的链路再加上高峰期丢包、限速等因素速度慢是很正常的。这跟你的宽带大小没有直接关系你就算拉了千兆光纤瓶颈也不在你这一端。这就解释了为什么有人用下载工具多线程下载也没用因为单线程慢还能靠多线程提速可如果是整个链路响应迟钝多线程照样跑不动。真正有效的办法只有一个换一条离你近、链路质量好的下载通道也就是国内镜像。2.2 官方下载渠道怎么访问、怎么选版本Git官方下载页面的地址是git-scm.com/downloads这个页面会根据你的操作系统自动推荐对应版本。页面结构比较简单但有几个细节容易看花眼Windows用户要分清32位和64位安装包现在绝大多数电脑都是64位系统但如果你不确定自己的系统位数可以先按Win Pause键打开系统信息看一眼。选错位数虽然也能装但装出来的环境有些第三方工具调用时会报兼容性错误没必要踩这个坑。官方网站同时提供便携版Portable和标准安装版Standalone Installer两种文件。便携版不需要安装解压就能用适合做U盘工具或者临时环境标准版会写入系统注册表和右键菜单适合长期开发使用。绝大多数人应该选标准版我见过有新手下载了便携版后找不到右键菜单入口绕了不少弯路。另外提醒一句官网上的Latest source release下面是源码包不是安装包。源码包需要自己编译安装新手不要碰这个直接往下找到Windows或者macOS对应的二进制安装包下载即可。2.3 国内镜像源盘点哪个能用、怎么选国内镜像站是解决下载慢最常见、也最稳妥的方案。几个主流镜像源各有特点我按推荐程度排个序说明。清华大学开源软件镜像站mirrors.tuna.tsinghua.edu.cn是我用得最多的一个。它的Git仓库路径清晰更新及时基本当天同步官方版本而且带宽非常充足下载速度基本能跑满你的宽带。访问方式是在镜像站首页搜索git进入git-for-windows目录后下载对应版本。阿里云镜像站mirrors.aliyun.com同样有Git的Windows构建版本速度也很稳。它的目录结构比清华稍微隐蔽一点需要找到git-for-windows这个路径。阿里云的特点是国内节点多不同地区的访问速度差异不大。华为云镜像站mirrors.huaweicloud.com也提供Git相关资源不过它更侧重Linux发行版和容器镜像Git for Windows的更新速度有时候会慢一些不建议作为首选但可以作为备选。还有一点值得注意GitHub官方仓库的Releases页面里也能找到Git的安装包但GitHub本身访问就不稳定下载速度同样没保障不建议从这条路径入手。部分企业内网也有自己的软件仓库如果是公司电脑优先问一下运维同事有没有内网源那个速度才是真的快。2.4 用表格对比一下几个下载渠道渠道访问速度国内更新及时性适用场景Git官网git-scm.com慢容易失败官方最新海外用户或网络条件较好的场景清华TUNA镜像极快基本当天同步国内首选个人和服务器均适用阿里云镜像极快同步及时国内备选多地区速度均衡华为云镜像快偶尔延迟备选或华为云服务器内网使用GitHub Releases不稳定官方最新不推荐作为下载Git安装包的常规路径3. Git安装全流程实操Windows、Linux、macOS一次讲透3.1 Windows环境下的Git安装步骤从镜像站下载好的exe文件一般叫Git-2.x.x.x-64-bit.exe这种格式。双击运行后安装向导会引导你一路点Next但有几个关键选项如果你直接默认过去后面使用的时候会折腾半天。第一个关键选项出现在Select Components页面。这一页有很多复选框建议勾选Additional icons下的On the Desktop创建桌面图标方便快速打开。更关键的是Windows Explorer integration下面的两个选项一个是Git Bash Here一个是Git GUI Here这两个一定要勾上它们会在鼠标右键菜单里加入Git Bash和Git GUI入口日常使用会方便很多。尤其是Git Bash它是Windows下最常用到的命令行环境如果没有在右键菜单里添加入口之后每次想打开都要手动找到安装目录麻烦不说还容易让新手误以为Git没装好。第二个关键选项在Choosing the default editor页面。这里要选择Git默认使用的文本编辑器。默认是Vim但Vim对新手极不友好打开配置文件后不知道怎么编辑和退出我见过不少人在这一步被劝退。建议选择Use Notepad或者Use Visual Studio Code前提是这些编辑器已经提前装好。如果你暂时没装任何第三方编辑器也先选Vim等后面的操作需要编辑文件时再说不影响Git本身的正常工作。第三个关键选项是Adjusting your PATH environment这一页。这里必须选择中间项Git from the command line and also from 3rd-party software。如果选了第一项只从Git Bash里使用Git那么在正常的CMD或PowerShell窗口里输入git命令会提示找不到选了第三项虽然功能不受影响但会把一些Unix命令也带到系统环境里容易和Windows本身的命令产生冲突不是必要需求的话不建议选。后面的几个页面包括换行符处理方式Checkout Windows-style, commit Unix-style line endings、远程连接协议Use the OpenSSL library、以及终端模拟器选择保持默认即可这些配置对大部分日常场景都是最优解。全部点完后开始安装速度很快几分钟内完成。3.2 安装完成后的验证和环境确认安装结束后打开任意一个CMD窗口或者PowerShell窗口输入git --version如果返回类似git version 2.45.1.windows.1的信息说明安装成功。这一步一定要做我遇到过很多人装完以为成功了结果打开命令行输入git提示不是内部或外部命令原因多半是前面PATH那一步选错了选项或者是安装完没有重新打开终端窗口。环境变量是在安装过程中写入系统的已经打开的终端不会自动刷新所以在验证之前务必把已打开的CMD、PowerShell、VS Code等程序全部关闭再重新打开。再验证一下Git Bash能否正常启动。在桌面或文件夹空白处点右键菜单里应该出现Git Bash Here点击后能弹出类似Linux终端的黑色窗口。Git Bash的窗口里可以执行ls、cd、pwd这类Linux命令这些命令在Windows原生CMD里是跑不了的这也代表着Git自带的模拟环境已经正常工作。3.3 Linux环境下的Git安装命令Linux发行版安装Git基本靠包管理器一行命令搞定但需要注意区分不同发行版的包管理器。Debian、Ubuntu系列使用aptsudo apt update sudo apt install git -yCentOS、RHEL、Fedora这些Red Hat系新版本用dnf老版本用yumsudo dnf install git -y # 或者 sudo yum install git -yArch Linux使用pacmansudo pacman -S git这些包管理器安装的Git版本可能不是最新的但对绝大多数开发场景足够用了。如果你确实需要安装更新的Git版本有两个思路一个是添加官方维护的第三方软件源比如针对Ubuntu的git-core/ppa另一个是下载源码手动编译。手动编译的流程大致是到Git官网或镜像站下载源码包解压后依次执行make configure、./configure --prefix/usr/local、make all、sudo make install。这里要注意编译之前必须确保系统已经安装了gcc、make、autoconf等编译工具链否则会在configure阶段报一堆缺失依赖的错误。不是刚需的话我还是建议直接用包管理器省时省力。3.4 macOS环境下的Git安装方式macOS没有自带Git至少新版本系统是这样的安装方式主要有三种。第一种用Homebrew安装这是macOS上最主流的包管理器。执行brew install git如果还没装Homebrew安装Homebrew本身又是一道坎这里不再展开。第二种是下载图形化安装器即在Git官网的macOS下载页面找到对应版本下载dmg文件后双击安装。这种方式的安装过程和Windows类似一路继续、安装、完成同样别忘了在终端里验证git --version。第三种是Apple官方提供的Command Line Tools它是独立于Xcode的一套命令行开发工具里面也包含Git。安装命令是xcode-select --install这种方式的好处是省去了单独装Git的步骤坏处是版本更新依赖Apple的系统更新通常版本会偏旧对Git新特性有依赖的项目可能会遇到兼容问题。我的建议是如果你的主力环境是macOS做开发优先用Homebrew安装版本新、更新方便。3.5 安装完成后的第一件事配置用户名和邮箱装好Git之后第一件该做的事不是急着clone代码而是配置你的身份信息。Git每次提交代码的时候都会记录提交者的名字和邮箱如果没配置提交时要么报错要么提交记录里的显示名是乱起八糟的默认值。打开Git BashWindows或终端Linux/macOS依次执行git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com--global参数表示全局生效也就是说这台电脑上所有仓库的提交都会使用这个身份信息。如果你想针对某个仓库单独设置身份可以在仓库目录下执行不带--global的配置命令优先级会覆盖全局配置。验证配置是否生效执行git config --global --list会输出user.name和user.email两行信息。这一步配置好了后续提交代码才不会遇到各种身份相关的报错。4. 安装只是开始基础配置和SSH密钥这里讲透4.1 为什么SSH密钥几乎是必配项配置好用户名和邮箱之后下一个高频操作就是和远程仓库建立连接。现在主流的代码托管平台不管是国内还是国外的都提供了HTTPS和SSH两种远程连接协议。HTTPS协议的使用最简单clone的时候直接填仓库地址推送代码的时候输入账号密码或者个人访问令牌Personal Access Token就能操作。但坑也在这里GitHub早就取消了账号密码的直接认证现在用HTTPS必须用token而token的权限管理如果不熟练很容易遇到权限不足的报错。SSH协议则不需要每次操作都输入账号密码。它通过一对密钥完成身份验证私钥留在本地公钥放到代码托管平台的后台。这种方式的体验要好得多配置一次之后就畅通无阻。所以我强烈建议所有人都配置SSH密钥这也是代码托管平台官方文档里推荐的连接方式。4.2 SSH密钥生成实操从生成到部署在Git BashWindows或终端Linux/macOS里执行ssh-keygen -t rsa -b 4096 -C 你的邮箱example.com这里的-t rsa指定密钥类型-b 4096指定位数位数越大越安全4096是当前主流选择-C后面的内容通常写你的邮箱它会作为一个备注信息写入公钥文件中方便识别这枚密钥属于谁。执行后系统会问你要把密钥保存在哪里默认路径是用户目录下的.ssh文件夹直接回车使用默认路径即可。接下来会提示设置一个口令passphrase这相当于给私钥加一层保护每次使用私钥的时候需要输入口令。如果你不想每次操作都输口令可以直接回车跳过安全性稍微低一点但日常开发便利性更高。我个人的习惯是本地开发环境不设口令公司电脑和服务器上设置口令折中处理。生成完成后在.ssh目录下会多出两个文件。id_rsa是私钥绝对不能泄露不要发给任何人也不要复制到其他地方id_rsa.pub是公钥是可以公开的内容我们需要把公钥内容拿到代码托管平台上去配置。查看公钥内容的命令是cat ~/.ssh/id_rsa.pubWindows的Git Bash里也可以执行同样的命令它会输出一串以ssh-rsa开头、以你刚才填写的邮箱结尾的文本。把这整段内容复制下来。接下来登录你的代码托管平台进入设置页面找到SSH Keys或SSH公钥管理入口。以常见的GitHub为例路径是Settings - SSH and GPG keys - New SSH key。标题随意填写比如my-laptopKey那一栏粘贴刚才复制的公钥内容点保存即可。国内平台的操作路径大同小异一般在个人设置里都能找到类似入口。验证是否配置成功可以在终端执行ssh -T gitgithub.com如果看到类似Hi yourname! Youve successfully authenticated的提示说明密钥已经生效本地和远程仓库的连接已经打通。4.3 日常clone加速的替代思路镜像站点的使用配置好密钥之后就是日常的clone和push操作了。这里再提一个跟前面下载安装类似的场景就是clone位于国外托管平台上的开源项目时速度同样可能会很慢甚至超时失败。这是因为代码托管平台本身的服务器在境外网络链路问题在clone阶段会再次出现。解决的思路和下载Git安装包是相通的通过一个国内的镜像站点中转。现在有一些第三方平台提供了GitHub仓库的镜像服务访问方式通常是在原仓库地址前面拼接镜像站域名。举个例子你要clone的仓库地址是git clone https://github.com/user/repo.git用镜像站的地址来clone就是把前面的一段替换成镜像域名后面的路径保持原样。这样数据会从国内节点传输速度明显更快。这里必须强调一个安全原则第三方镜像站只能用来下载公开仓库的代码绝对不能用来操作你的私有项目也不要在镜像站页面里输入任何账号密码和token信息。自己公司的核心代码还是通过正常配置的远程仓库地址来操作。镜像站是解决访问速度问题的临时手段不是改写的正式工作流。如果你有多个上游仓库要切换可以在已经clone好的本地仓库里修改远程地址。查看当前远程地址用git remote -v修改远程地址用git remote set-url origin 新地址这样就不用重新clone一遍代码了直接在原有基础上切换源省流量也省时间。5. 高频问题排查下载、安装、配置阶段的坑我替你踩过了5.1 下载阶段进度条不动、下载中断怎么处理下载Git安装包时最常见的两个问题是卡在某个百分比不动和下载到一半直接失败。卡住的情况优先考虑浏览器下载是否被安全软件拦截。Windows自带的Defender或者是第三方杀毒软件有时候会把从互联网下载的exe文件当成潜在威胁导致下载中断。解决方法是临时关闭实时防护或者把下载目录加入白名单。下载多次失败的情况下不要死磕同一个渠道。我实测过的经验是官网下载失败换清华镜像基本都能解决清华镜像偶尔因为高峰期带宽紧张换个阿里云镜像可能反而更快。多准备几个下载源哪个能用用哪个。还有一种情况是下载速度看着很快但安装包校验不过提示文件损坏。这种情况多半是下载过程中数据出错要么重新下载要么换个渠道下载。下载完成后可以比较一下文件大小是否和页面上标注的一致对不上的话果断删掉重新下载。5.2 安装阶段Windows安装卡住、报错的处理Windows上安装Git卡住的情况虽然不多但一旦出现就很让人头疼。最常见的原因是安装路径有问题。如果安装向导的路径指向某个带中文的目录名或者目录权限受限安装进程会一直转圈或者报Access denied。建议把安装路径直接设置到C:\Program Files\Git保持默认不动不要自作聪明改到其他奇怪的目录。另一个容易让人误判的情况是安装到最后一步的时候窗口一直停在Installation completed不消失。这个其实是安装向导在等待用户点击Finish按钮不是卡死了直接点掉就行。如果是企业电脑还可能遇到没有管理员权限导致安装无法继续的情况。Git安装包在写入系统目录时需要管理员权限普通域账号如果没被授予安装权限安装向导会在某个阶段弹出UAC提示框这时候不要点取消要选择是来授权。5.3 安装成功后git命令找不到怎么办明明安装成功了打开CMD输入git --version却提示找不到命令这种情况十有八九是两种原因。第一种是安装时PATH那一步选错了选项。解决办法是重新运行一遍安装程序选择Modify模式在PATH配置那一页改成Git from the command line and also from 3rd-party software。这样系统环境变量会被重新写入然后重启终端就能生效。第二种是安装时没有勾选任何PATH相关选项这种情况不但需要重新安装修改配置还可能需要在系统环境变量里手动添加Git的路径。操作步骤是右键我的电脑 - 属性 - 高级系统设置 - 环境变量在系统变量里找到Path编辑并新增Git的bin目录路径通常是C:\Program Files\Git\bin。注意要使用完整路径不要用相对路径。5.4 配置阶段用户名邮箱和SSH密钥的常见坑用户名邮箱配置了却不生效这种情况通常发生在多仓库环境下。git config --global是全局配置但如果你在某个仓库目录下执行过不带--global的配置仓库级别的配置会覆盖全局配置。排查方法是进入仓库目录执行git config --list这会列出当前仓库使用的所有配置项从上往下的顺序中靠后面的配置会覆盖前面的同名配置。看到多个user.name或user.email时注意分辨哪个是全局的、哪个是仓库级的。SSH密钥配置完成后连接仍然失败优先排查密钥指纹是否匹配。执行ssh -T gitgithub.com如果返回Permission denied (publickey)说明服务器没有识别你的公钥重新检查公钥是否完整地粘贴到了后台以及粘贴时是否不小心多复制了空格或换行。5.5 问题速查表现象原因解决方案官网下载极慢或失败访问境外服务器链路差改用清华、阿里云等国内镜像站安装包下载后提示损坏下载过程中数据出错换渠道重新下载核对文件大小安装向导卡在启动阶段安装路径含中文或权限不足使用默认安装路径确认管理员权限git命令提示找不到PATH配置错误或未重开终端重装并选择正确PATH选项或手动加环境变量提交代码报身份错误未配置user.name和user.email执行git config --global配置SSH连接Permission denied公钥未正确配置到平台重新粘贴公钥验证密钥指纹clone国外仓库慢原仓库服务器链路差使用镜像站点地址clone公开仓库6. 我的个人建议按这个顺序来少走弯路这篇文章写到这里核心的内容基本都覆盖了。最后分享一点我自己在实际操作中总结出来的经验也算是一个推荐的操作顺序。第一次在电脑上安装Git的时候不要一上来就去官网点下载按钮先想清楚自己的网络环境和电脑配置。我的建议是Windows用户直接打开清华镜像站找到最新版的64位安装包下载速度基本是秒完装的时候老老实实用默认路径注意把PATH那个选项选对装完先验证git --version然后立刻把用户名和邮箱配上再顺手生成一份SSH密钥、把公钥加到代码托管平台上。这一套流程走完你的Git环境就算真正能用了后面再开始clone代码体验会非常顺畅。等熟悉了基础操作之后再把git remote、分支切换、冲突解决这些日常命令练熟。还有一个小技巧如果在clone某些项目的时候发现仓库太大、历史记录很多导致clone很慢可以先用git clone --depth 1做浅克隆只拉最新一次提交需要完整历史的时候再执行git fetch --unshallow来补充实测在仓库很大的场景下能省不少时间。工具链这种东西配置好了一次受益很久所以初期的这些安装配置步骤真的值得认真对待。