工欲善其事必先利其器。做开发的人绕不开Git不写代码的人其实也值得装一个Git。很多人第一次接触Git是在Win10上下载好了安装包结果被安装向导里一堆看不懂的选项劝退或者装完发现右键菜单变了、命令行里git命令不认、中文文件名乱码……这篇文章就把Win10安装Git的完整流程、每个选项背后的原理、装完之后该怎么验证和配置、以及我踩过的坑一次讲清楚。无论你是刚起步的编程新手还是被各种安装问题折磨过的老油条照着这篇文章走一遍基本不会再翻车。1. 为什么装Git之前要先搞懂这件事1.1 版本控制到底解决什么问题先说点实在的Git不是某个编辑器的插件也不是只能用在某个代码托管平台上它是一个分布式的版本控制系统。你写论文、做设计稿、改配置文件甚至写一份长文档只要内容在反复修改就会遇到“改坏了想退回上一版”“想对比昨天和今天的差异”“几个版本都不想丢”这类需求。Git的核心能力就是把文件的每次变化都记录下来随时能回到任何一次历史状态还能在多个版本之间切换、合并、对比。在Win10上装Git本质上就是给这个系统装一套命令行工具集它不是一个图形软件而是几十个小命令的集合。装好之后你能在终端里输入git init、git add、git commit这些指令也能通过右键菜单快速打开命令行窗口。很多人装完觉得“什么都没发生”因为Git没有桌面图标它的入口在命令行里。1.2 哪些人需要这份教程如果你属于下面任意一类这篇文章就是为你准备的刚学编程、教程里第一步就是“先安装Git”的初学者日常需要和团队协作、要用版本管理工具但一直没系统配置过的人电脑装了Git但又不敢卸载重装、怕配置丢失的人纯粹想用一个稳定好用的文件历史回溯工具、不写代码也想尝试的人。我遇到最多的困惑来自第一类人他们的教程说得太简略只说“安装时全部默认”结果遇到换行符转换、路径选择这类概念时完全懵。下面就从安装前的准备开始把每一步都拆开讲。2. 安装之前的准备选对版本比瞎下载更重要2.1 先确认你的Windows 10系统状态Win10有32位和64位两种系统架构大部分现代电脑都是64位但老电脑或者某些精简版系统可能是32位。安装Git之前先确认系统类型在桌面右键“此电脑”选“属性”在“系统类型”一栏能看到“64位操作系统”或“32位操作系统”。这个决定你下载哪个安装包选错了会直接装不上或者装上后一堆奇怪的问题。同时看一眼系统版本号Win10的设置里找“系统→关于”可以看到Windows规格里有个版本号比如22H2、21H2之类。版本太老的话某些新版Git的安装包可能提示缺少系统组件。如果遇到这种情况先更新系统再装Git别硬装。2.2 下载哪个安装包64位还是32位Git官网提供多个安装包格式常见的有64位版安装包文件名里带“64-bit”字样适用于绝大多数Win10 x64系统32位版安装包文件名里带“32-bit”字样适用于老系统便携版portable不需要安装解压就能用但不推荐新手使用因为环境变量和右键菜单都要手动处理。下载的时候认准64-bit即可。有些下载站会提供各种“增强版”“绿色版”“一键安装包”我不建议用。Git本体是开源软件从官网下载最安全第三方打包的版本可能捆绑插件也可能改了默认配置出了问题很难排查。2.3 几个容易踩的下载坑下载这块有三个坑值得提前说第一官网下载速度慢。Git的安装包大概几十兆如果网络状况不好下载进度条可能半天不动。解决办法是换网络环境或者用下载工具又或者找可信的镜像站但下载后一定要比对文件是否完整——最直观的方法是看安装包能不能正常打开。第二安装包会附带一些额外的工具比如Git Bash、Git GUI、OpenSSL库等。这些是Git运行的基础组件安装时要保留不要为了“干净”而取消它们。很多人装完发现git命令在终端里无法识别就是因为安装时手动取消了相关组件或者修改了PATH选项后面细说。第三如果你的Win10开启了UAC用户账户控制安装过程中可能弹几次权限确认窗口。这是正常的直接点“是”就行但要注意安装路径不要放在需要管理员权限才能写入的目录比如系统盘的Program Files通常没问题但某些被策略限制的目录就会因为权限不够导致安装失败。3. 安装向导的每一步别只看“Next”3.1 安装向导页面里的选项到底在问什么Git的安装向导在Win10上会展开大约十几个页面新手看到每个页面都点Next确实也能装完但有些默认选项并不适合所有人。我把关键页面挑出来讲装之前心里有数。第一页是许可协议GPL协议读完点“Next”就行可以读也可以不读。第二页是安装路径默认装在“C:\Program Files\Git”下。我的建议是保持默认。虽然很多软件可以装到D盘但Git的命令行工具会被多个编辑器、IDE自动查找默认路径兼容性最好。装了非默认路径后面某些工具找不到git可执行文件反而多一堆麻烦。接下来是“选择组件”页面这里有几个勾选项需要注意“Additional icons”里的“On the Desktop”可以勾也可以不勾只是在桌面创建快捷方式没实际作用“Windows Explorer integration”建议保持勾选这个提供了右键菜单的“Git Bash Here”和“Git GUI Here”入口使用体验提升很大“Git LFS”这个组件是用于管理大文件的建议勾上现在很多项目和资源包都会用到“Associate .git* configuration files with the default text editor”和“Associate .sh files to be run with Bash”两个关联选项建议按默认状态保留否则双击某些脚本文件会用不对的软件打开。3.2 三个最容易选错的页面有三个页面选项选错之后很折腾必须一个一个说清楚。第一个是“选择默认编辑器”。安装向导会让你在Vim、Nano、Notepad等编辑器里选一个作为Git的默认编辑器。Git的默认选择是Vim很多新手在这里没有任何概念就直接Next。结果有一天执行git commit时发现诶怎么打开了一个全键盘操作的界面鼠标动不了不知道怎么写内容不知道怎么保存退出只能强制关掉窗口然后Git卡在编辑状态里。这里给个经验如果你不清楚Vim的操作方法就选其他编辑器。比如你已经装了某款常用编辑器就在这里选它如果没装任何外部编辑器可以考虑选Nano——它至少屏幕底部有操作提示比Vim友好得多。如果就是想在Git里用Vim那也行但至少要记住两条命令按键盘I键进入插入模式开始打字按Esc退出插入模式输入“:wq”保存并退出。第二个是“调整PATH环境变量”这个页面这是新手最容易翻车的地方。选项有三个“仅从Git Bash使用Git”这种模式下在Cmd和PowerShell里输入git是找不到命令的只有Git Bash里能用“从命令行以及第三方软件使用Git”这种模式会把Git的bin目录加入系统PATH推荐选这个“仅从Git Bash使用Git并启用一些实验性特性”等等属于特殊场景不推荐。默认选项一般是中间那个“Git from the command line and also from 3rd-party software”新版安装器有时候默认是第一个很多教程也会建议选默认。我的建议是明确选择第二个因为我们日常在Win10里打开终端PowerShell或Cmd输入git命令的场景非常多如果PATH没配置好就会出现“git不是内部或外部命令”的报错。第三个是“配置换行符转换方式”。这个页面有三个选项很多人不明所以地选了第一个然后项目里的代码文件出现一堆红色差异或者报错。这里解释一下第一个选项“Checkout Windows-style, commit Unix-style line endings”意思是检出代码时把行尾符转换成Windows的CRLF提交时转回Unix的LF。如果在Windows上做开发且项目是多人协作这个选项是常见选择第二个选项“Checkout as-is, commit Unix-style line endings”意思是检出时保持原样提交时转成LF第三个选项“Checkout as-is, commit as-is”意思是完全不转换。没有绝对正确的选项取决于你参与了什么类型的项目。如果你在纯Windows环境自己学习选第三个“不转换”反而最省心——不会因为Git自作主张改你的换行符。如果你要参与跨平台协作项目团队一般会提供.gitattributes文件来统一规范此时选哪个问题都不大因为文件规则会覆盖本机设置。新手如果不知道选什么我推荐选第三个至少不会遇到一堆“整个文件都被标红”的诡异差异。3.3 后面那些页面该怎么看后面的“终端模拟器选择”页面默认是“MinTTY”这个可以根据个人喜好MinTTY的显示效果更好推荐保持默认。“拉取行为”“凭证管理器”“符号链接”这些页面没有特殊需求都选默认即可。有一个“启用文件系统缓存”之类的性能选项默认勾选保持默认。还有一个“配置凭证管理器”的选项默认是“Git Credential Manager”这是特别推荐的因为它能在你首次连接代码托管平台时记住账号密码或Token不用每次输入。如果取消这个组件后面每次推送都要重新认证非常痛苦。整个向导走下来核心原则是这样只要不是特别明白某个选项是干嘛的就尽量保持默认但“PATH环境变量”和“默认编辑器”这两个页面要主动确认不要蒙着头Next。安装过程本身大概一两分钟如果系统防病毒软件弹窗允许Git相关文件运行即可。4. 装完之后的第一件事验证和初始化配置4.1 怎么确认Git真的装好了安装完成后先别急着开发打开一个终端窗口。按Win键输入“powershell”或者“cmd”打开后输入git --version如果显示类似git version 2.xx.x.windows.x这样的输出就说明Git成功安装且PATH配置正确了。执行以下命令查看Git的安装位置where git在PowerShell里也可以这样确认Get-Command git | Select-Object Source如果提示“git不是内部或外部命令”问题一定出在PATH配置上。解决方案有两个不用卸载重装去“系统属性→环境变量→Path”里手动添加Git安装目录下的cmd文件夹路径比如C:\Program Files\Git\cmd保存后重新打开终端再试如果不想手动改环境变量也可以用安装器自带的“修改”功能重新跑一遍安装向导到“调整PATH环境变量”页面改成第二项安装器会帮你配置好。4.2 初始化配置用户名和邮箱Git装好后它还不知道你叫什么。每次提交代码时Git会把提交者和作者信息写进记录里如果没配置提交时会报错或者显示一堆问号。配置命令如下git config --global user.name 你的名字 git config --global user.email 你的邮箱这里的名字和邮箱会出现在你的提交历史里建议用你能记住、愿意公开的代号和邮箱如果在代码托管平台上用可以和平台账号一致但注意它们不一定要是注册邮箱。--global的意思是全局生效如果不加这个参数那么配置只对当前仓库生效。可以执行下面的命令检查配置git config --list另外最好设置一下默认分支名。以往Git默认分支是master现在新版本有些默认用main你可以明确指定git config --global init.defaultBranch main这一步不是必须的但如果你后面用命令行执行git init指定默认分支名可以减少一些平台差异上的小麻烦。4.3 Git Bash是什么和PowerShell有什么区别装Git会一并安装一个叫“Git Bash”的程序很多人不解Win10上有PowerShell和Cmd干嘛还要一个Git Bash简单说Git最初是在Linux、Unix环境下发展的很多命令行习惯和路径写法跟Windows不一样。Git Bash就是给Windows用户准备的一个模拟Linux命令行环境的终端里面那些命令比如ls、pwd、cd在Windows下也能用而且路径风格更接近Unix方便参考Linux风格的教程和脚本。它的入口一个是开始菜单里的“Git Bash”另一个是从文件夹右键里选“Git Bash Here”。我的建议是日常操作完全可以用PowerShell或Cmd只要保证能运行git命令就行。但如果你遇到教程里写了rm -rf或者sudo之类的命令这些是Unix命令在PowerShell里不识别这时就切到Git Bash里去执行。两个环境共存不冲突装好了都用得上。装完Git之后界面没有明显的“Git软件”入口这是很正常的。Git就是工具箱你的使用入口是终端你的图形入口是IDE或代码编辑器里集成的那套界面。5. 常见问题与排查技巧实录5.1 下载慢、安装报错怎么办下载慢的问题前面提到过可以用镜像站或者更换网络出口。安装报错比较常见的有两种一是提示“无法写入注册表”或“权限不足”。这多半是系统限制或者杀毒软件拦截了安装程序。解决办法右键安装包选择“以管理员身份运行”关闭干扰型的杀毒软件装完再开重新执行安装。二是提示“另一个程序正在安装”或安装进度条到某一步卡死。这种情况通常是系统里有一个卡住的MSI安装服务进程。解决方案是重启电脑清理临时文件再重新运行安装包。如果依然报错打开任务管理器找到Windows安装服务相关进程结束掉再重新安装。5.2 右键菜单为什么没有“Git Bash Here”这个问题的原因和状态分几种安装时没有勾选“Windows Explorer integration”系统策略禁止了右键菜单扩展或者你用的是精简版系统Shell扩展组件被裁掉了。如果安装时已经勾选了但缺失最快的修复办法是重新运行安装包选择“Modify”把“Windows Explorer integration”勾起来。如果右键菜单还是死活不出现也可以直接在开始菜单里打开Git Bash用cd命令切到项目目录再操作功能上完全一样只是少个便捷入口而已。5.3 中文文件名、提交信息乱码怎么办Win10下Git处理中文有时会显示为八进制转义序列或者乱码。打开Git Bash执行git config --global core.quotepath false这个命令让Git在显示中文文件名时不转义。如果提交信息乱码还需要调整终端编码Git Bash窗口右键标题栏选“Options”或“属性”把字符集改成UTF-8。在PowerShell里可能需要设置[Console]::OutputEncoding [System.Text.Encoding]::UTF8如果要在全局层面搞定编码可以在Git配置里加上git config --global gui.encoding utf-8 git config --global i18n.commit.encoding utf-8 git config --global i18n.logoutputencoding utf-8这些配置对多数中文环境有效能够减少乱码问题的发生。5.4 换行符自动转换导致整个文件被标记为修改明明只改了几行代码一执行git diff却发现几百行差异大概率是换行符问题。因为Windows是CRLF回车换行Linux/Mac是LF仅换行Git如果自动转换就会造成这种假差异。排查方法先关闭自动转换在仓库里执行git config --local core.autocrlf false然后重新用git add和git diff看差异是否恢复正常。如果冲突已经写进了暂存区可以执行git add --renormalize .这个命令会用当前的换行符设置重新规范化文件。如果项目里有.gitattributes文件里面的规则是最高优先级那就要看文件里是怎么规定的别单靠本机配置硬猜。5.5 想卸载重装怎么办卸载Git之前先备份你的全局配置。Git的所有全局配置保存在用户主目录下的.gitconfig文件里把这个文件复制一份到安全位置。然后到“设置→应用”里卸载Git。卸载不会删除你的仓库历史仓库里的.git目录是独立的不会因为卸载而丢失。重装时软件会重新创建右键菜单和PATH配置。装好后把备份的.gitconfig放回原位置你的用户名、邮箱、换行符偏好和别名设置就都回来了。有个小坑如果你之前配置过Code托管平台的凭证卸载可能不会清楚所有缓存重装后首次连接平台时新版的凭证管理器一般会重新拉起登录按提示操作即可。5.6 其他值得留意的细节安装Git后很多代码编辑器会自动识别Git这是好事。但如果编辑器提示找不到Git路径一般可以在编辑器设置里手动指定指到C:\Program Files\Git\bin\git.exe即可。最好不要同时安装两个不同版本或来源的Git容易造成PATH混乱导致某个软件调用到旧版本。对于使用WSLWindows Subsystem for Linux的用户需要注意WSL里的Linux环境和Win10里的Windows Git是两个独立的Git环境配置和凭证互不相通。如果你两边都用建议两边的用户名和邮箱保持一致否则提交历史里会出现两种不同的作者信息。平时使用Git时最让人头疼的不是安装而是误操作。安装初期建议专门建一个测试目录执行git init、git add、git commit、git log这些命令把基本流程跑顺再上真实项目。我就是这样练出来的比看十遍教程都管用。6. 几个我从实战中总结出来的小经验如果只说一点那就是别迷信“全默认”。Windows上安装Git的默认选项偏向于多数用户场景但“默认编辑器”和“PATH选项”这两个点对使用体验影响太大值得花一分钟明确选择。我第一次装的时候就是全默认结果后来在重装系统后重新配置Git时才发现PATH配置没选对导致编译器集成、命令行调用都出了状况排查了很久。换行符的问题新手很容易忽视。我印象很深的一次是帮朋友看一个文件为何莫名其妙大量改动排查到最后就是他的Git默认把CRLF转换成了LF导致整个目录都被Git判定为“变更”。这个现象在Win10里太常见了早一点知道core.autocrlf的配置选项就能省掉大量排查时间。最后建议大家在装完Git后花十分钟打开一个终端把git help里的常用命令扫一遍心里有个概念。装好Git只是开始真正让工作变高效的是后面的各种使用习惯。这篇文章的每一步我都是按自己被坑过的顺序来写的照着操作你的Win10环境应该不会再和Git闹别扭了。
