Git 这玩意儿现在基本是开发者的标配工具了。不管你是写 Python、搞前端、做 Java 后端还是偶尔帮同事拉个开源项目看看代码第一步永远绕不开把它装到 Windows 上。但别看这事儿听起来简单我见过太多人卡在下载哪个版本装完命令行找不到 gitgit config 配了半天没生效这些坑里。这篇内容就是把我这些年帮人装 Git、配 Git 的经验完整梳理一遍从下载、安装、验证到基础配置每一步都讲清楚为什么这么做、哪里容易出问题。适合完全没接触过 Git 的新手也适合装过但配置总出问题的朋友对照排查。关键词覆盖 Git、Windows、安装教程、git config、git --version 这些核心点读完你至少能做到装好、验证通过、配置可用、能正常拉代码提交。1. 装之前先想清楚为什么 Windows 上装 Git 有这么多种方式很多人一搜Git 下载安装教程出来的结果五花八门有人让你去官网下 exe有人推荐用 winget 一行命令搞定还有人让你装个 Git for Windows 之外的客户端比如小乌龟TortoiseGit。这就容易让人懵——到底该选哪个其实这些方式背后对应的是不同的使用场景选错了不是不能用而是后面会多绕弯路。1.1 官方 Git for Windows 安装包最通用也最稳的选择Git 本身是 Linux 内核那套生态里长出来的工具最初在 Windows 上并没有原生支持。Git for Windows 这个项目就是专门把 Git 移植到 Windows 平台同时打包了一个叫 Git Bash 的模拟环境让你在 Windows 上也能用接近 Linux 的命令行体验。官网下载的 exe 安装包是绝大多数人的首选原因很简单它自带 Git Bash、Git GUI、Git CMD 三种入口还内置了 MinGW 环境能跑大部分 shell 脚本。我一般建议新手直接走这条路。为什么因为它的安装向导虽然步骤多但每一步都有默认值你一路 Next 基本不会出大问题而且装完之后环境变量、PATH 配置都是自动搞定的省心。相比之下如果你用 winget 或者 chocolatey 这类包管理器装虽然命令一行就完事但万一环境变量没配好排查起来对新手不太友好。1.2 包管理器安装适合已经习惯命令行的老手Windows 10 之后自带了 wingetWindows 11 更是默认就有。用winget install --id Git.Git -e --source winget这一条命令就能把 Git 装好。这种方式的好处是升级方便winget upgrade就能批量更新。但它有个前提你的系统得能正常访问 winget 源而且装完之后 PATH 的刷新有时候需要重开终端才生效。如果你是在公司内网环境winget 源被限制那就还是老老实实下 exe。1.3 图形客户端小乌龟等不是替代品是补充TortoiseGit 这类工具经常被误认为是另一个 Git其实它只是调用底层 Git 命令的图形外壳。也就是说你必须先装好 Git for Windows再装 TortoiseGit它才能工作。很多人只装了 TortoiseGit 发现用不了就是因为底层 Git 没装。所以顺序永远是先装 Git 本体再考虑要不要加图形客户端。提示如果你只是偶尔拉个代码看看不打算深入用命令行那装完 Git for Windows 之后直接用 Git GUI 就够了不必额外装小乌龟。2. 下载环节版本、位数、来源这三个细节别搞错下载这一步看似简单但每年都有人下错版本。我整理了几个最容易出问题的点对照着检查一遍能省不少事。2.1 认准官网来源别从第三方下载站拿安装包Git 的官方网站是 git-scm.com这是唯一官方发布渠道。你在搜索引擎里搜出来的很多高速下载绿色版破解版站点里面的安装包可能被捆绑了其他软件甚至被篡改过。Git 本身完全免费开源没有任何需要破解的地方所以看到破解版 Git这种字眼直接跳过就行。进入官网后首页右侧会自动识别你的系统给出对应的下载按钮。Windows 用户点进去会跳到 Git for Windows 的发布页面gitforwindows.org这里才是真正的下载入口。2.2 32 位还是 64 位现在基本无脑选 64 位Git for Windows 提供 Standalone Installer 的 32 位和 64 位两个版本。判断方法很简单打开设置 → 系统 → 关于看系统类型那一栏。如果写的是基于 x64 的处理器就选 64 位如果是 ARM 架构比如某些 Surface Pro X那要选 ARM64 版本。现在还在用 32 位系统的机器已经非常少了除非你手上是十几年前的老设备否则直接选 64 位。选错了会怎样32 位装到 64 位系统上其实也能跑但性能会打折扣反过来 64 位装到 32 位系统上直接报错装不上。2.3 Portable 版和 Installer 版的区别下载页面除了 Standalone Installer还有一个 Portable便携版。便携版不需要安装解压就能用适合放在 U 盘里随身带或者在公司电脑上没有管理员权限时使用。但它的缺点是环境变量不会自动配你得手动把它的 bin 目录加到 PATH 里否则在任意目录下敲 git 命令会提示找不到。我个人的建议是自己电脑上用 Installer 版一劳永逸如果是临时借用别人电脑或者受限环境再用 Portable 版。版本类型适用场景是否自动配 PATH升级便利性Standalone Installer 64位个人电脑常规使用是重新下载覆盖安装Standalone Installer 32位老旧 32 位系统是同上Portable 便携版无管理员权限、U盘携带否需手动替换解压目录winget 安装已习惯命令行是winget upgrade 一键3. 安装向导逐页拆解每一屏到底在问你什么Git for Windows 的安装向导大概有十来个页面很多人一路 Next 过去了但其实里面有几个选项会影响后续使用体验。我按顺序把关键页面讲一遍你对照着装。3.1 许可协议与安装路径第一屏是 GPL 许可协议直接 Next。第二屏是选择安装位置默认是C:\Program Files\Git。这里我建议保持默认除非你的 C 盘空间实在紧张。为什么不建议改到 D 盘因为 Git 的路径里如果包含中文或空格某些老旧的构建脚本可能会出问题而Program Files这个路径虽然带空格但 Git 自己处理得很好反而是你自定义的路径更容易踩坑。如果你确实要改路径记住一条路径里不要出现中文、不要出现特殊符号用纯英文和数字最保险。3.2 组件选择页这几个勾选项值得留意这一页列出了要安装的组件默认勾选的有Additional icons桌面快捷方式和快速启动栏图标看个人喜好Windows Explorer integration右键菜单集成这个建议勾上后面在文件夹里右键就能直接Git Bash Here非常方便Git LFS大文件支持如果你要处理超过 100MB 的文件比如设计稿、数据集建议勾上Associate .gitconfiguration files with the default text editor*把 .gitconfig 等文件关联到默认编辑器一般勾上Associate .sh files to be run with Bash把 .sh 脚本关联到 Bash 运行做脚本开发的话勾上Use a TrueType font in all console windows控制台字体优化勾上没坏处我的习惯是除了桌面图标看情况其他全勾。这些组件占不了多少空间但后面用到的时候省得再折腾。3.3 默认编辑器选择别选 Notepad这一页会让你选 Git 默认使用的编辑器选项里有 Vim、Nano、Notepad、Visual Studio Code 等。默认是 Vim但 Vim 对新手极不友好——你进去之后不知道怎么退出网上一堆如何退出 Vim的段子就是这么来的。我的建议是如果你已经装了 VS Code直接选 VS Code如果没装选 Nano 也比 Vim 强Nano 底部有快捷键提示CtrlO 保存、CtrlX 退出一目了然。实在不想装任何编辑器选 Notepad 也能用只是功能弱一些。注意这个编辑器是在你执行git commit不带-m参数时弹出的用来写提交信息。选一个你熟悉的能省很多事。3.4 PATH 环境变量配置这一页最关键这一页有三个选项Use Git from Git Bash only只在 Git Bash 里能用 git 命令其他终端不行Git from the command line and also from 3rd-party software推荐把 Git 加到系统 PATH任何终端都能用Use Git and optional Unix tools from the Command Prompt连 Unix 工具也加进去可能覆盖 Windows 自带的 find、sort 等命令强烈建议选第二项。这是默认选项也是最适合大多数人的。选第一项的话你在 CMD 或 PowerShell 里敲 git 会提示不是内部或外部命令很多人装完发现用不了就是这个原因。选第三项要谨慎因为它会把 Unix 的 find.exe 加到 PATH 前面可能影响某些依赖 Windows find 命令的脚本。3.5 换行符处理跨平台协作的核心设置这一页是 Git 在 Windows 上最容易被忽视、也最容易出问题的设置。Windows 用 CRLF回车换行作为行尾Linux 和 macOS 用 LF换行。如果不处理跨平台协作时会出现整个文件都变了的诡异 diff。三个选项Checkout Windows-style, commit Unix-style line endings推荐检出时转成 CRLF提交时转成 LFCheckout as-is, commit Unix-style line endings检出不转换提交转 LFCheckout as-is, commit as-is完全不转换默认是第一项对大多数在 Windows 上开发、代码要提交到远程仓库的场景来说这个设置最省心。如果你团队里全是 Windows 用户且不涉及跨平台选第三项也行。但只要你有可能和 Linux/macOS 同事协作就保持默认。3.6 终端模拟器与其余选项后面几页分别是Choose the default terminal emulator选 MinTTY默认还是 Windows 控制台。MinTTY 支持更好的字体和窗口缩放保持默认即可Choose the default behavior ofgit pull选默认的 Default (fast-forward or merge) 就行Choose a credential helper选 Git Credential Manager这样你拉取私有仓库时不用每次输密码Configuring extra options文件系统缓存、符号链接支持保持默认勾选最后点 Install等进度条走完安装就完成了。4. 装完先别急着用三步验证确保环境真的没问题安装向导走完不代表就万事大吉了。我见过不少人装完之后直接开项目结果各种报错回头才发现是环境没配好。所以装完第一件事是验证。4.1 用 git --version 确认命令可用打开一个新的终端窗口一定要新开因为 PATH 的更新对已经打开的终端不生效输入git --version正常的话会输出类似git version 2.47.0.windows.1这样的信息。如果提示不是内部或外部命令说明 PATH 没配好。这时候有两个排查方向检查安装时是不是选了第一项只在 Git Bash 里可用检查系统环境变量 PATH 里有没有 Git 的 cmd 目录手动添加 PATH 的方法右键此电脑→ 属性 → 高级系统设置 → 环境变量 → 在系统变量里找到 Path → 编辑 → 新增一行C:\Program Files\Git\cmd如果你改了安装路径对应调整。保存后重新打开终端再试。4.2 在 Git Bash 里再验证一次除了系统终端也打开 Git Bash开始菜单里能找到或者在任意文件夹右键选Git Bash Here同样输入git --version。这一步是确认 Git Bash 环境本身没问题。如果系统终端能用但 Git Bash 不能用那可能是安装不完整建议重新安装。4.3 检查 git config 是否可读写输入git config --list如果这是全新安装可能只会输出几行系统级配置。如果报错说找不到配置文件那可能是用户目录权限有问题。正常情况下这个命令应该能正常输出不报错。5. git config 配置装完必须做的几件事Git 装好之后如果不配置用户名和邮箱你连第一次 commit 都做不了。这一节把必配项和选配项都讲清楚。5.1 配置用户名和邮箱这是提交的身份标识git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com这两条命令是必须执行的。--global表示全局配置对当前用户的所有仓库生效。如果你某个项目想用不同的身份可以在那个项目目录下不加--global再配一次局部配置会覆盖全局。邮箱这里有个细节如果你用 GitHub建议填你 GitHub 账号绑定的邮箱这样提交记录才能正确关联到你的账号。如果你不想暴露真实邮箱GitHub 提供了用户名users.noreply.github.com这种隐私邮箱在 GitHub 设置里能找到。5.2 配置默认分支名跟上主流习惯Git 2.28 之后支持自定义默认分支名。以前默认是master现在主流平台都改成了main。你可以这样设置git config --global init.defaultBranch main这样以后git init创建的新仓库默认分支就是 main和 GitHub、GitLab 的默认保持一致省得每次推送还要改名。5.3 配置换行符和大小写敏感前面安装时选过换行符处理但如果你想在配置层面再确认一下git config --global core.autocrlf trueWindows 上一般设为 true。另外还有一个大小写敏感的配置git config --global core.ignorecase false这个设置是让 Git 区分文件名大小写。Windows 文件系统本身不区分大小写但 Git 仓库里是区分的。如果你团队里有 macOS 或 Linux 用户建议设为 false避免出现Readme.md和readme.md被当成同一个文件的混乱。5.4 配置代理和凭证管理按需如果你在公司内网可能需要配置代理才能访问远程仓库git config --global http.proxy http://proxy.example.com:8080 git config --global https.proxy http://proxy.example.com:8080不需要的时候记得取消git config --global --unset http.proxy git config --global --unset https.proxy凭证管理方面安装时如果选了 Git Credential Manager第一次拉取私有仓库时会弹出登录窗口登录一次之后就会记住后续不用重复输入。5.5 查看和修改已有配置配置完之后用这条命令查看所有配置git config --global --list如果想修改某一项重新执行对应的 config 命令即可新值会覆盖旧值。想删除某一项用--unsetgit config --global --unset user.name配置文件本身存在C:\Users\你的用户名\.gitconfig你也可以直接用文本编辑器打开它手动改效果一样。配置项命令是否必配用户名git config --global user.name 名字必配邮箱git config --global user.email 邮箱必配默认分支git config --global init.defaultBranch main建议换行符git config --global core.autocrlf true建议大小写敏感git config --global core.ignorecase false按需代理git config --global http.proxy ...按需6. 装完 Git 之后常见的几个坑和排查思路这一节是我这些年帮人处理问题时总结出来的高频故障按出现频率排序。6.1 命令行提示git 不是内部或外部命令这是最高频的问题九成以上是 PATH 没配好。排查顺序确认安装时选了第二项Git from the command line and also from 3rd-party software检查系统环境变量 Path 里有没有C:\Program Files\Git\cmd确认终端是新开的不是安装前就开着的如果都对了还不行重启一次电脑再试如果用的是 Portable 版那必须手动加 PATH因为便携版不会自动配。6.2 Git Bash 里中文显示乱码这个问题的根源是字符编码。Git Bash 默认用 UTF-8但 Windows 控制台可能是 GBK。解决方法是在 Git Bash 里执行git config --global core.quotepath false这个设置让 Git 不把中文路径转义成八进制。另外可以在 Git Bash 窗口标题栏右键 → Options → Text → Locale 设为zh_CNCharacter set 设为UTF-8。6.3 提交时提示Please tell me who you are这就是没配 user.name 和 user.email。按第 5.1 节的命令配一下就行。注意如果你在多个项目里看到这个提示可能是某个项目目录下有局部配置覆盖了全局配置检查一下项目里的.git/config文件。6.4 拉取代码时提示 SSL 证书错误公司内网环境常见通常是自签名证书或者代理拦截导致的。临时解决方案是git config --global http.sslVerify false但这会降低安全性只建议在确认内网安全的前提下临时使用。更正规的做法是把公司的根证书导入到 Git 的证书库或者联系 IT 部门配置正确的证书链。6.5 文件名大小写改了但 Git 没识别Windows 文件系统不区分大小写你把readme.md改成Readme.mdGit 可能认为没变化。这时候用git mv readme.md Readme.md强制 Git 记录这次重命名。或者先git rm --cached readme.md再git add Readme.md。7. 装好之后的第一步跑通一个最小可用流程环境配好了配置也做了接下来最好用一个最小流程验证整条链路是通的。我一般会让人做这么几件事7.1 创建一个测试仓库并完成首次提交mkdir git-test cd git-test git init echo hello git test.txt git add test.txt git commit -m first commit如果这几步都顺利说明 Git 的本地功能完全正常。git init会创建一个.git隐藏目录里面存放版本历史。git add把文件加入暂存区git commit提交到本地仓库。7.2 关联远程仓库并推送如果你有 GitHub 或 Gitee 账号可以创建一个空仓库然后git remote add origin https://github.com/你的用户名/仓库名.git git branch -M main git push -u origin main第一次推送会弹出登录窗口Git Credential Manager登录后就能推上去。如果推送成功说明网络、认证、远程配置整条链路都没问题。7.3 验证 git log 和 git statusgit log --oneline git statusgit log能看到刚才的提交记录git status显示工作区干净。这两个命令是日常用得最多的确认它们正常输出基本就说明环境没问题了。提示如果你用的是 Gitee推送地址格式是https://gitee.com/你的用户名/仓库名.git配置流程完全一样。SSH 方式的话需要先生成密钥并添加到平台新手建议先用 HTTPS 方式跑通。8. 关于升级和卸载后续维护的几点经验Git 的升级比较简单官网下载新版安装包直接覆盖安装即可配置和仓库都不会丢。如果你想用命令行升级winget 装的可以用winget upgrade Git.Git手动装的还是重新下 exe 最稳。卸载的话控制面板里正常卸载就行。但要注意卸载不会删除你的.gitconfig文件和已有的仓库这些需要手动清理。如果你打算重装其实不卸载直接覆盖安装也可以配置会保留。另外提一句Git 的版本不需要追新。除非新版本有你需要的特性否则稳定版用着就行。我见过有人为了用某个新命令升级到最新版结果遇到兼容性问题又降回去的。生产环境求稳个人学习可以尝鲜。最后分享一个我自己的习惯装完 Git 之后我会把常用的配置写成一个脚本文件比如setup-git.sh里面包含用户名、邮箱、分支名、换行符这些配置命令。换电脑或者重装系统时跑一遍脚本就全配好了不用一条条敲。这个习惯帮我省了不少重复劳动你也可以试试。