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 endings
- Checkout 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里能用git，cmd里用不了，非常不方便。
后面还有几屏：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 验证安装是否成功
安装完成后，先别急着用。打开一个新的命令行窗口（Win+R输入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 git@gitee.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 --wait"（VS 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 status，git 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的笔记，把安装时的选项、配置的命令、遇到的问题都记下来。下次再装，直接照着笔记走，五分钟搞定。这个习惯帮我省了很多重复劳动，推荐你也试试。