1. 为什么2026年还要认真装一次Git先把结论放前面Git不是“装完就完事”的软件它在Windows上的安装方式、默认编辑器、换行符处理策略、PATH环境变量这几项直接决定了你后面半年会不会被各种莫名其妙的报错折磨。我见过太多人装完Git之后第一次提交代码就遇到warning: LF will be replaced by CRLF或者敲git提示“不是内部或外部命令”又或者git commit突然弹出一个完全不会用的vim界面卡在那里退不出来。这篇内容就是把我自己这些年反复装Git、帮同事装Git、在全新Windows机器上从零配Git的经验完整地梳理一遍。不管你是刚接触版本控制的新手还是换了新电脑需要重新搭环境的老手照着走一遍基本能避开90%的常见坑。核心关键词先自然带出来Git安装、Windows、Git配置、Git下载、Git安装教程。这几个词后面会反复出现在具体操作里但我不会硬堆而是跟着实际步骤走。Git本质上是一个分布式版本控制系统你可以把它理解成给代码文件夹装了一台“时光机”——每次commit就是拍一张快照随时能回到任何一个历史版本还能开分支并行开发互不干扰。在Windows上装Git官方提供的Git for Windows也叫Git Bash那一套是最主流的选择它同时给你三样东西Git命令行本体、一个模拟Linux风格的Bash终端、以及一个图形化的Git GUI。对绝大多数人来说装这一个就够了。适合谁看完全没装过Git的Windows用户、装过但配置一团糟想重来的、以及需要在新机器上快速搭好开发环境的人。下面我按“下载→安装→验证→配置→实战”的顺序把每一步的意图和坑都讲清楚。2. 下载前的准备与版本选择思路2.1 确认系统位数与下载渠道第一步永远是确认你的Windows是64位还是32位。现在2026年了绝大多数机器都是64位但保险起见还是看一眼桌面右键“此电脑”→“属性”在“系统类型”那一栏会写“基于 x64 的处理器”或“基于 ARM64 的处理器”。如果是ARM架构的Windows比如某些Surface要下对应的ARM64版本别下成x64的虽然能跑但性能不是最优。下载渠道我只推荐一个Git for Windows的官方站点。搜索“git for windows”进官网点Download它会自动识别你的系统给出推荐版本。不要从各种“软件下载站”下那些站点的安装包经常被捆绑东西或者版本老旧。官方安装包名字类似Git-2.4x.x-64-bit.exe体积大概60到70MB。提示下载时留意一下版本号。2026年主流稳定版已经在2.4x以上。如果官网首页给的是最新版直接用最新稳定版就行Git的向后兼容做得很好不用担心新版本不兼容老项目。2.2 安装包类型Standalone还是Portable官网下载页通常会给两个选项Standalone Installer独立安装程序和Portable便携版。我强烈建议选Standalone。便携版虽然不用安装、解压即用但它不会自动帮你配PATH环境变量也不会集成到右键菜单后续用起来反而麻烦。Standalone安装程序会引导你完成所有关键配置省心得多。另外还有一个细节安装程序分“64-bit Git for Windows Setup”和“64-bit Git for Windows Portable”。认准Setup那个。下载完成后建议核对一下文件大小是否正常如果只有几MB那多半是下载中断了重新下。2.3 安装前要不要先卸载旧版本如果你机器上已经有Git先别急着覆盖安装。打开命令行敲git --version看看当前版本。如果版本不算太老比如2.3x以上其实没必要重装。但如果你的Git配置已经乱了或者想彻底重来那就先去“控制面板→程序和功能”里把旧的Git卸载掉再装新的。覆盖安装有时候会残留旧的PATH配置导致新老版本混用出现一些诡异问题。我个人的习惯是换大版本比如从2.3x到2.4x时干净卸载重装小版本更新直接覆盖。这样最稳。3. 安装向导逐屏拆解与关键选项3.1 许可协议到安装路径双击安装包第一屏是GPL许可协议点Next。第二屏是安装路径默认是C:\Program Files\Git。这个路径我建议不要改除非你的C盘实在紧张。原因很简单很多工具和脚本默认会去这个路径找Git改了之后你可能要手动配一堆东西。如果非要改路径里不要有中文和空格这是铁律。接下来几屏是组件选择。默认勾选的组件里有几个值得注意Windows Explorer integration这个就是右键菜单里的“Git Bash Here”和“Git GUI Here”。建议保持勾选以后在任意文件夹右键就能打开Git终端非常方便。Git LFS大文件存储支持。如果你会用到Git管理图片、视频、大模型权重文件勾上。普通代码项目用不到但勾上也没坏处。Associate .gitconfiguration files with the default text editor*这个建议取消勾选。原因后面讲默认编辑器时会说。Use a TrueType font in all console windows勾上终端字体好看点。3.2 默认编辑器别选Vim除非你真的会用这一屏是新手翻车重灾区。安装程序会让你选Git的默认编辑器选项里有Vim、Nano、Notepad、VS Code等。如果你不会用Vim千万不要选Vim。因为一旦选了以后每次git commit不带-m参数时Git就会打开Vim让你写提交信息而你如果不会Vim的保存退出命令:wq就会卡在那个界面出不来只能强关终端。我的建议如果你装了VS Code选VS Code如果没装选Nano比Vim友好底部有快捷键提示实在不行选Notepad记事本虽然简陋但至少你会用。等以后熟悉了再改配置也行改起来就一行命令的事。注意这个选择只影响“不带-m的commit”和“merge冲突时的编辑”等场景。日常git commit -m xxx完全不受影响。但为了长远考虑还是选个你真正会用的编辑器。3.3 换行符处理Windows上最容易被忽略的坑这一屏叫“Adjusting your PATH environment”之后的“Configuring the line ending conversions”三个选项Checkout Windows-style, commit Unix-style line endings推荐Checkout as-is, commit Unix-style line endingsCheckout as-is, commit as-is选第一个。这是Git for Windows的默认推荐也是跨平台协作最稳的方案。它的逻辑是检出checkout到工作区时把换行符转成Windows的CRLF提交commit时再转回Unix的LF。这样你在Windows上用记事本打开文件不会出现“所有内容挤在一行”的情况同时提交到仓库的又是标准的LF跟Linux/macOS同事协作不会冲突。如果你选第三个“as-is”那跨平台协作时换行符就会乱套出现大量“整个文件都变了”的假diff。这个坑我踩过一个文件明明只改了一行diff却显示全文件修改排查半天才发现是换行符问题。3.4 终端模拟器与PATH环境终端模拟器选“MinTTY”默认。MinTTY是Git Bash自带的终端支持调整窗口大小、复制粘贴更顺手。别选“Windows console”那个是老式的cmd窗口体验差很多。PATH环境这一屏选**“Git from the command line and also from 3rd-party software”**推荐。这个选项会把Git的可执行文件加到系统PATH里这样你在任意cmd或PowerShell窗口里都能直接敲git命令。如果选“Use Git from Git Bash only”那就只有Git Bash里能用gitcmd里用不了非常不方便。后面还有几屏HTTPS传输后端选OpenSSL默认证书存储选“Use the native Windows Secure Channel library”默认符号链接选“Enable symbolic links”默认不勾也行看需求。最后是实验性功能比如“Enable experimental support for pseudo consoles”这个一般不用勾除非你遇到某些交互式程序在Git Bash里跑不起来的问题。全部选完点Install等进度条走完勾选“Launch Git Bash”点Finish安装就完成了。4. 安装后验证与基础配置4.1 验证安装是否成功安装完成后先别急着用。打开一个新的命令行窗口WinR输入cmd或者直接开PowerShell敲git --version如果输出类似git version 2.4x.x.windows.1说明PATH配置成功安装没问题。如果提示“不是内部或外部命令”那说明PATH没配上要么重装时选错了选项要么需要手动加PATH。再敲一个where git这个命令会列出所有叫git的可执行文件路径。正常应该输出C:\Program Files\Git\cmd\git.exe。如果输出了多个路径说明你机器上有多个Git版本需要清理一下。4.2 必做的三项全局配置装完Git第一件事配置用户名和邮箱。这两个信息会写进每一次commit记录里是身份标识git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com邮箱建议用你代码托管平台如Gitee、GitHub等注册时用的邮箱这样提交记录能正确关联到你的账号。第二件事配置默认分支名。Git老版本默认分支叫master现在主流平台都改成main了。为了避免每次新建仓库都要手动改直接配全局git config --global init.defaultBranch main第三件事配置换行符策略跟安装时选的一致但显式配一遍更保险git config --global core.autocrlf true在Windows上这个值设为true含义就是前面说的“检出转CRLF提交转LF”。4.3 查看和修改配置所有全局配置存在用户目录下的.gitconfig文件里。想看当前所有配置git config --global --list想改某一项重新执行git config --global 键 值即可覆盖。想删掉某一项git config --global --unset 键名我建议装完Git后把这几项配置截图存一下以后换电脑直接照着配省得回忆。5. 从零跑通第一个仓库的完整实操5.1 初始化仓库与首次提交找个空文件夹比如D:\git-demo在里面右键选“Git Bash Here”打开终端。依次执行git init这会在当前目录创建一个隐藏的.git文件夹所有版本历史都存在里面。然后创建一个测试文件echo hello git readme.txt查看当前状态git status你会看到readme.txt是红色的“Untracked files”表示Git还没跟踪它。把它加入暂存区git add readme.txt再git status文件变绿了表示已暂存。提交git commit -m first commit: add readme到这里你就完成了一个完整的“工作区→暂存区→本地仓库”的流程。这三个区域是Git的核心概念工作区是你实际编辑文件的地方暂存区是准备提交的“购物车”本地仓库是提交后的历史存档。5.2 关联远程仓库与推送本地仓库建好了如果想同步到远程平台Gitee、GitHub等需要先在平台上创建一个空仓库拿到仓库地址HTTPS或SSH格式。然后git remote add origin 你的仓库地址 git push -u origin main-u参数的作用是把本地main分支和远程origin/main关联起来以后直接git push就行不用再写完整参数。如果用的是SSH地址需要先配SSH密钥。生成密钥ssh-keygen -t ed25519 -C 你的邮箱一路回车密钥默认存在~/.ssh/id_ed25519和id_ed25519.pub。把.pub文件里的内容复制到平台的SSH公钥设置里。然后测试连接ssh -T gitgitee.com看到欢迎信息就说明配好了。SSH方式配一次以后都不用输密码比HTTPS方便。5.3 日常高频命令速查跑通第一个仓库后下面这些命令是你每天都会用到的命令作用使用频率git status查看当前状态极高git add .添加所有改动到暂存区极高git commit -m 说明提交极高git pull拉取远程更新高git push推送本地提交高git log --oneline查看简洁提交历史高git diff查看未暂存的改动中git branch查看分支中git checkout -b 分支名新建并切换分支中git log --oneline这个特别推荐输出一行一条清爽。默认的git log会输出一大堆作者、日期信息翻起来累。6. 常见问题排查与避坑经验6.1 安装与配置类问题问题一敲git提示“不是内部或外部命令”。原因基本是PATH没配好。解决重新运行安装程序在PATH那一屏选“Git from the command line and also from 3rd-party software”。或者手动把C:\Program Files\Git\cmd加到系统环境变量Path里。改完要重开命令行窗口才生效。问题二git commit弹出vim不知道怎么退出。按Esc然后输入:wq回车保存退出或者:q!回车不保存退出。根本解决方法是改默认编辑器git config --global core.editor code --waitVS Code或git config --global core.editor nano。问题三中文文件名显示成乱码。执行git config --global core.quotepath false。这个配置让Git不转义非ASCII字符中文就能正常显示。问题四每次push都要输密码。换成SSH方式或者配置凭据缓存git config --global credential.helper manager。Windows上Git自带凭据管理器配一次以后自动记住。6.2 换行符与冲突类问题问题五diff显示整个文件都改了但实际只改了一行。这就是换行符不一致导致的。检查git config core.autocrlf的值Windows上应该是true。如果项目里有.gitattributes文件以那个为准。实在乱了可以执行git add --renormalize .重新规范化。问题六merge冲突了怎么办。冲突文件里会出现、、标记。手动编辑文件保留你想要的内容删掉这些标记然后git add 冲突文件再git commit完成合并。VS Code有内置的冲突解决界面比手动改直观。问题七提交信息写错了想改。如果还没push用git commit --amend -m 新的信息。如果已经push了改完需要git push --force但强推有风险团队协作时慎用。6.3 独家避坑心得第一条心得装完Git先配user.name和user.email再干别的。我见过有人写了半个月代码提交记录里全是默认的“Administrator计算机名”想改都改不了历史。第二条心得项目根目录放一个.gitignore文件。把node_modules、__pycache__、.idea、*.log这些不需要版本控制的东西写进去。不然git add .会把一堆垃圾文件加进去仓库瞬间膨胀。第三条心得大文件不要直接commit。Git对二进制大文件不友好一个几百MB的文件提交进去仓库体积就下不来了。用Git LFS管理或者干脆别放仓库里。第四条心得定期git gc。Git仓库用久了会产生很多松散对象git gc会打包压缩能显著减小.git文件夹体积。我有个项目.git从2GB压到400MB。7. 进阶配置与效率提升7.1 配置别名简化常用命令Git允许给命令起别名把长命令缩短。编辑全局配置git config --global alias.st status git config --global alias.co checkout git config --global alias.br branch git config --global alias.ci commit git config --global alias.lg log --oneline --graph --all配完之后git st就等于git statusgit lg能输出带分支图的漂亮历史。这几个别名我用了好多年效率提升明显。7.2 配置代理与镜像源合规场景如果你在公司内网访问外部代码托管平台慢可以配置HTTP代理。注意这里说的是企业内网合规代理不是其他用途git config --global http.proxy http://代理地址:端口 git config --global https.proxy http://代理地址:端口取消代理git config --global --unset http.proxy git config --global --unset https.proxy另外国内访问某些平台慢的话可以考虑用Gitee作为镜像或者配置平台的镜像源。这个看团队实际需求。7.3 与VS Code等编辑器的集成VS Code内置了Git支持装完Git后VS Code会自动识别。在VS Code里左侧源代码管理面板能看到所有改动点一下就能暂存、提交、推送不用敲命令。对于日常简单操作图形界面确实快。但复杂操作比如rebase、cherry-pick、解决复杂冲突还是命令行更靠谱。我的习惯是日常提交用VS Code面板遇到复杂情况切到Git Bash敲命令。两者配合效率最高。VS Code里还可以装GitLens插件能看到每一行代码是谁在什么时候改的排查问题时特别有用。7.4 多账号与多平台配置如果你同时用Gitee和GitHub或者有公司账号和个人账号需要配置多套SSH密钥。方法是生成不同的密钥文件然后在~/.ssh/config里配置Host gitee.com HostName gitee.com User git IdentityFile ~/.ssh/id_ed25519_gitee Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519_github这样访问不同平台时自动用对应的密钥互不干扰。这个配置稍微复杂点但配一次以后一劳永逸。8. 卸载与重装的正确姿势有时候Git配置彻底乱了或者想换个大版本需要卸载重装。正确流程是先备份你的全局配置cp ~/.gitconfig ~/.gitconfig.bak在Git Bash里执行。控制面板卸载Git。手动检查并清理残留C:\Program Files\Git文件夹如果还在就删掉用户目录下的.gitconfig可以保留重装后能直接用但如果你想彻底重来就一起删。检查系统环境变量Path里有没有残留的Git路径有就删掉。重新下载安装包按前面的步骤装一遍。装完把备份的.gitconfig恢复回去或者重新配一遍。重装后第一件事还是验证git --version和where git确认环境干净。9. 我个人的几条实在建议装Git这件事说简单也简单一路Next也能用说讲究也讲究几个关键选项选错了后面就是无尽的麻烦。我的建议是第一次装的时候多花十分钟把默认编辑器、换行符、PATH这三项选对后面能省下几十个小时的排查时间。另外别怕命令行。Git的图形工具很多但命令行才是通用技能换台机器、换个平台都能用。刚开始记不住命令没关系git status会告诉你当前能做什么git help 命令能查文档。用多了自然就熟了。最后分享一个我自己的习惯每台新机器装完Git我会建一个git-setup.md的笔记把安装时的选项、配置的命令、遇到的问题都记下来。下次再装直接照着笔记走五分钟搞定。这个习惯帮我省了很多重复劳动推荐你也试试。