刚把电脑换成 Win11第一件事不是装浏览器不是调桌面而是给 Git 安排上。你要是问为什么我只能说不管你是写代码、做项目文档、还是跟同事/同学协作同一个文件夹里的东西Git 这东西迟早绕不过去。而在 Windows 上Git 的安装和环境配置又确实有点啰嗦——下载、安装、选选项、改配置、配 SSH、验证登录随便一步走偏后面 push 代码的时候准会跳出来一堆莫名其妙的报错。这篇教程我按照 2026 年最新的 Git 版本情况来写全程以 Win11 系统为例从下载到安装再到环境配置每一步都说明白“为什么这么选”不是简单丢给你一串“下一步”。我还会把 Git 安装过程中最常见的坑、右键菜单找不到了、中文乱码、每次都要输密码这类问题一起整理进去。只要跟着走基本半小时内能搞定而且以后换电脑也能照着抄。1. 装 Git 之前先搞清楚这几件事1.1 Git 到底是什么为什么 Win11 上尤其需要Git 是一个分布式版本控制系统简单说就是给文件做“版本快照”的工具。写代码的时候今天的代码能把项目跑起来明天改完就崩了没有 Git 的话你只能靠复制文件夹来留备份。有了 Git你可以在任何一个改动点“存档”随时回到过去任意一个正常状态。很多新手会用“Git 和 GitHub 是一回事吧”这种问题其实不是。Git 是本地工具GitHub、Gitee、GitLab 这些是基于 Git 的远程代码托管平台。你本地用 Git 管版本远程用平台存代码、协作、提 issue两者配合使用。Win11 不像 macOS 自带 Git 环境也不像 Linux 发行版一行命令就能装所以需要手动安装配置这也是这篇教程存在的原因。1.2 2026 年了该下载哪个版本Git 的版本迭代其实非常快尤其是 Git for Windows几乎每个月都会有小版本更新。到 2026 年Git 2.5x 的版本线早就是主流了。你只要记住一个原则去官网下载最新的稳定版不要下载带有 rc、preview 字样的预览版也不要为了“图新鲜”去下载刚从仓库编译出来的开发版。架构方面也要留意一下系统位数。目前绝大多数人的电脑都是 64 位系统下载文件名里带-64-bit的安装包就行。如果你正好是比较老的 32 位系统那只能去找-32-bit的包。打开 Win11 的“设置 - 系统 - 系统信息”看一眼“系统类型”就能确认。1.3 安装前的准备工作清单别急着双击安装包先花两分钟把环境检查一遍确认系统是 Win11且已安装最新的系统更新。Win11 的右键菜单和旧版有差别这会影响后面“Git Bash Here”入口的位置后面第 5 部分会细说。关闭正在运行的第三方杀毒软件或者至少对安装包和安装目录设置信任。Git 安装包本身没有毒但部分杀软对“向环境变量写入内容”这一动作比较敏感容易误拦截。准备好网易邮箱、QQ 邮箱或者 Gitee/GitHub 注册邮箱后面配置用户名和 SSH 密钥都要用。如果你网络下载官网很慢可以用国内镜像站下载这一点我下面会展开说。2. Git 下载与安装全过程2.1 官方渠道与国内镜像怎么选Git 官方下载地址是git-scm.com/download/win页面上会直接识别你的系统并给出推荐安装包。正常情况下点进去就能下载但如果你在下载时发现速度只有几 KB 或者直接超时不用头铁换国内镜像反而是更稳的方案。目前被广泛使用的镜像源有清华大学的 tuna 镜像、腾讯软件源、以及阿里云的镜像站。以清华 tuna 为例进入mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/目录找到最新版本号对应的文件夹进去选择Git-版本号-64-bit.exe下载即可。镜像站的文件和官网是一模一样的只是 CDN 在国内下载速度快很多。下载完成后建议顺手校验一下安装包哈希值。官网或镜像站会把对应的 SHA-256 写出来Win11 下用 PowerShell 执行Get-FileHash 你的安装包路径对比一下结果是否一致。这一步主要是防止下载文件损坏我自己吃过亏装完才发现文件不完整报错报得莫名其妙校验一下能省掉很多后面的事。2.2 安装向导每一步该怎么选Git 安装向导的选项非常多很多新手在这里被吓住。其实真正需要理解的选项就那么几个我按照安装顺序一个个说。选择安装路径默认路径是C:\Program Files\Git我建议不要改特别是不要放到中文路径或者带空格的路径下。虽然现在 Git 对中文路径的容忍度提高了但后续如果跟其他开发工具联动很容易因为路径问题踩坑。选择组件这一步出现的复选框比较多默认基本都勾着。这里重点说几个Git Bash Here和Git GUI Here一定要保留这是右键菜单的入口后面操作最常用的就是 Git Bash。Associate .git configuration files with the default text editor可以勾选这样双击.gitconfig文件时能直接用文本编辑器打开。Associate .sh files to be run with Bash这一项看个人需求如果你以后会接触到 shell 脚本保留它是好事。选择默认编辑器默认选 Vim但绝大多数新人在 Vim 里写完 commit 信息后不知道怎么保存退出直接被卡死。如果你电脑里装了 VS Code、Notepad 或者 Sublime Text我强烈建议在这里就把它选成默认编辑器。没有的话也建议继续往下装完再回头配置成记事本以外的编辑器。这个选择只影响你用git commit时打开文本编辑器的方式不影响任何核心功能。调整 PATH 环境变量这一步是重中之重理论上讲三选一是互斥的最推荐的是中间那一项Git from the command line and also from 3rd-party software。这个选项会把 Git 的可执行目录加进系统 PATH让你在 cmd、PowerShell、以及各种 IDE 的终端里直接敲git命令。如果选了第一项你就只能从 Git Bash 里用 Git其他终端一律提示“git 不是内部或外部命令”。选择 HTTPS 传输后端这里有两个选项Use the OpenSSL library和Use the native Windows Secure Channel library。我建议选 OpenSSL这是 Git 自己带的证书验证体系兼容性更好特别是在国内访问一些代码托管平台时证书问题更少。换行符转换方式默认选项是Checkout Windows-style, commit Unix-style line endings也就是检出代码时转成 Windows 的 CRLF 换行提交时转成 Unix 的 LF 换行。这个默认选项适合绝大多数跨平台协作场景新手保持默认就行。如果你明确知道自己只在 Windows 上开发且项目成员也都是 Windows可以选第二个或第三个但我建议短期别纠结先保持默认。选择终端模拟器默认是 MinTTY另一个是 Windows console。MinTTY 的命令行体验更接近 Linux支持调整窗口大小、复制粘贴更顺手我建议用默认的 MinTTY。Windows console 的优势是跟系统终端保持一致但在响应速度和快捷键方面体验会差一些。git pull 行为默认是Default (fast-forward or merge)保持默认就好新手不要在这里改 rebase。等你对 Git 的分支合并逻辑有深刻理解了再去改成 rebase 也不迟。凭据管理器默认选Git Credential Manager这个一定要保留。它的作用是帮你记住 HTTPS 方式的账号密码避免每次 push 都要输一次。后面第 5 部分我会专门讲“每次 push 都要输密码”的问题根源几乎都在这里。额外选项默认勾选文件系统缓存file system caching这个能提升 Git 对大仓库的处理性能。符号链接支持的选项不建议开Windows 上开这个权限限制很多容易出莫名其妙的问题。一路继续安装直到完成。整个过程其实不需要动太多地方核心就是 PATH 和默认编辑器这两个选择。2.3 安装完成后的第一轮验证安装完成后重启一下终端关闭所有窗口再打开一次然后按Win R输入cmd在命令行里执行git --version如果输出类似git version 2.5x.x.windows.x说明安装成功且 PATH 配置正确。另外也可以单独打开“开始菜单”里的Git Bash在弹出的终端里同样执行一遍命令确认 Bash 环境能正常启动。如果cmd里提示找不到 git大概率是 PATH 选错了或者在安装时没有勾选“从命令行使用 Git”。这时候不用重装手动把C:\Program Files\Git\cmd加到系统环境变量里就能解决。3. 环境配置让 Git 真正变成你的工具3.1 设置用户名和邮箱为什么必须做Git 提交代码时每条 commit 都会记录作者信息这个信息就来自你的用户名和邮箱配置。如果你不配置Git 会尝试从系统用户名里猜猜不出来就报Please tell me who you are的错误。打开 Git Bash输入以下两行命令git config --global user.name 你的名字 git config --global user.email 你的邮箱注意这里的--global参数表示全局生效对当前电脑上的所有仓库有效。如果你某个具体仓库想用不同的身份可以去掉--global在该仓库目录下单独设置。实际开发中个人电脑用全局配置就够了公司电脑上如果分了多个 Git 账号再针对特定仓库做单独配置。配置完成后可以用git config --global --list查看所有全局配置项确认是否写入成功。配置文件的物理位置在C:\Users\你的用户名\.gitconfig你有兴趣可以直接打开看。3.2 换行符和中文显示相关的三处重点配置Win11 上装完 Git有几个人人都会遇到的显示和编码问题建议在正式使用前就配好。第一处是core.autocrlf。前面安装时保持默认的话这个值默认是true在 Windows 上会把文件里的 LF 换行自动转成 CRLF。如果你的项目成员里有用 macOS 或 Linux 的人这种默认行为其实是合理的。如果你就是自己写点脚本、笔记不跟别人协作可以执行git config --global core.autocrlf false让 Git 原样保留文件内容不碰换行符。这个没有绝对对错核心是团队内部必须统一。第二处是core.quotepath。默认情况下 Git 会把中文文件名转义成一串八进制编码比如\346\265\213\350\257\225.txt。执行git config --global core.quotepath false就能让git status和git log正常显示中文文件名而不是转义后的乱码。第三处是编码设置。为了让 Git 在显示提交信息时正确处理中文建议执行git config --global i18n.commitencoding utf-8 git config --global i18n.logoutputencoding utf-8然后还要保证 Git Bash 的字符集是 UTF-8。在 Git Bash 窗口标题栏右键 - Options - Text把 Character set 改成 UTF-8 即可。这样提交信息里写中文、日志里看中文基本不会再出乱码。3.3 配置 SSH 密钥并关联远程仓库这一步是整个环境配置里最容易被忽略但又最影响日常体验的一步。不配置 SSH 密钥你也能用 HTTPS 方式 clone 和 push 代码但每次都要输账号密码或者依赖凭据管理器里的记录配置好 SSH 密钥之后本地生成一对公私钥把公钥放到 Gitee 或 GitHub 上以后推送拉取走的是 SSH 协议免密且更安全。在 Git Bash 里执行ssh-keygen -t ed25519 -C 你的邮箱注意-t ed25519指定的是密钥算法相比传统的rsa更安全、速度更快、生成的密钥也更短。执行后会问你保存路径直接回车使用默认的~/.ssh/id_ed25519即可又会让你设置 passphrase密码短语这个是可以留空的如果填了后面每次使用密钥都要输入一遍。实际上个人开发留空更方便安全性主要依赖本机登录密码和系统的文件保护。生成完成后执行cat ~/.ssh/id_ed25519.pub把输出的公钥内容完整复制下来然后登录 Gitee进入“设置 - SSH 公钥”粘贴保存。GitHub 的操作路径是“Settings - SSH and GPG keys - New SSH key”逻辑一样。保存后测试连接ssh -T gitgitee.com首次连接会提示确认主机指纹输入yes回车。如果看到Hi 用户名! Youve successfully authenticated之类的提示说明 SSH 配置成功。之后再用 SSH 地址克隆或添加远程仓库就不需要再输入密码了。4. Git 核心操作装好之后这样用4.1 Git Bash 到底是干什么的很多新手装完 Git 后打开 Git Bash 一脸懵——一个黑乎乎的窗口左侧是路径右下是输入光标不知道能干什么。其实 Git Bash 就是 Windows 上的一个模拟 Linux 终端环境工具链里包含了 Git、Bash、以及ls、cd、mkdir、grep等常用命令。日常使用中你最常做的是cd切换目录切到项目文件夹然后执行 Git 命令。例如cd /d/code/my-project注意 Git Bash 里 Windows 的盘符路径要写成/d/而不是D:\这个细节第一次用的人大概率会卡住。另外你也可以在文件资源管理器里进入项目目录右键选择Git Bash Here这样打开后就直接定位到当前目录不用手敲路径最方便。4.2 常用 Git 命令速查与核心逻辑以下是一套最简版本的 Git 协作流命令不多但覆盖了 90% 的日常需求# 初始化仓库 git init # 查看状态 git status # 将文件加入暂存区 git add 文件名 git add . # 添加所有变动 # 提交到本地仓库 git commit -m 提交说明 # 查看提交历史 git log --oneline # 关联远程仓库 git remote add origin gitgitee.com:你的用户名/仓库名.git # 推送到远程 git push -u origin main # 拉取远程更新 git pull整个逻辑可以这样理解git add是把你选中的改动放进“购物车”git commit是把购物车里的东西打包成一次不可变的“存档”git push是把存档上传到远程git pull是从远程把别人的存档拉下来。理解了这个流程后面再学分支、合并、回退就顺了。4.3 提交信息写错了怎么办commit --amend 实战提交之后才发现 commit 信息写错了或者漏了一个文件不用懊恼。在还没有 push 的情况下执行git commit --amend -m 新的提交说明这个命令会把当前暂存区的改动合并进上一次提交同时替换掉上一次的提交信息。它本质上是“覆盖最近一条 commit”所以只适用在本地还没推送到远程的场景。如果已经 push 了不建议再用 amend因为会改写历史导致和你协作的人出现大量冲突。如果你只是想撤销暂存区的某个文件而不是改提交信息git restore --staged 文件名这个命令把暂存区的文件“移回”工作区不丢失你的改动。注意新版 Git 推荐用restore而不是旧版的reset HEAD 文件名后者还能用但语义没有前者清晰。4.4 关于那串看起来吓人的 git 参数命令很多人在 IDE 或某些 Git 图形工具的日志里会看到类似这样的命令git -c diff.mnemonicprefixfalse -c core.quotepathfalse --no-optional-locks ...第一反应是“我这 Git 是不是坏了怎么执行了一堆看不懂的东西”。其实完全不用慌这是很多图形化 Git 客户端比如 JetBrains 系列 IDE、VS Code 的 Git 插件、以及各种 GUI 工具在调用 Git 时主动注入的参数。-c表示临时修改某条配置项diff.mnemonicprefixfalse是让 diff 输出用 a/b 这样的标准前缀core.quotepathfalse是解决中文文件名转义问题--no-optional-locks是告诉 Git 在检查状态时不要获取可选的锁避免跟 IDE 自身的操作产生冲突。看到这串参数反而说明工具在正常调用你安装的 Git没有任何问题。5. 常见问题与排查技巧实录5.1 Win11 右键菜单里找不到 Git Bash HereWin11 默认右键菜单把常用操作折叠到了“显示更多选项”里所以新系统上你右键项目文件夹可能只能看到“显示更多选项”点进去才能找到Git Bash Here和Git GUI Here。这不是 Git 没装好而是 Win11 菜单策略变了。如果你实在觉得这个两段式操作太烦可以调整注册表把右键菜单改回 Win10 的经典样式运行regedit定位到HKEY_CURRENT_USER\Software\Classes\CLSID\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\InprocServer32把默认值设为空重启资源管理器即可。不过这是个全局修改会让整个右键菜单变回旧版介意的朋友可以继续用“显示更多选项”。5.2 中文文件名显示成八进制乱码git status里文件名变成\345\222\214...这样的情况几乎每个中文 Windows 用户都遇到过。原因就是前面 3.2 节里说的core.quotepath默认开了转义。执行git config --global core.quotepath false就能解决。这里特别注意改完之后已经存在的乱码显示不会自动恢复重新执行一次git status命令就能看到正常效果。如果是 Git Bash 里中文输入或显示乱码还要检查窗口字符编码是否为 UTF-8以及系统中区域设置是否支持 Beta 版 UTF-8。Win11 的“设置 - 时间和语言 - 语言和区域 - 管理语言设置 - 更改系统区域设置”勾选“Beta: 使用 Unicode UTF-8 提供全球语言支持”能一并解决很多中文编码问题但要注意这会改变系统默认编码部分老软件可能出现乱码建议谨慎操作。5.3 每次 push 都让你输入账号密码如果你用 HTTPS 方式克隆仓库每次 push 都提示输入用户名密码大概率是凭据管理器没有正常工作。先确认安装时是否勾选了Git Credential Manager如果勾了可以执行git config --global credential.helper manager这个配置会启用凭据管理器第一次输过密码后系统会记住。再不行就检查一下系统凭据管理器里是否已经存了旧的错误凭据Win11 搜索“凭据管理器” - “Windows 凭据”找到git:https://gitee.com这类条目删除后重新 push按提示输入正确的账号密码。如果你早就看 HTTPS 输密码不顺眼直接按第 3.3 节配好 SSH 密钥把远程地址从 HTTPS 换成 SSH一劳永逸。5.4 打开 commit 编辑器后卡住也不知道怎么退出这个问题真的能劝退一大波新手。当你执行git commit不带-m时Git 会打开默认编辑器如果不小心保持默认的 Vim你会在一个看似“卡死”的界面里不知所措。Vim 的入门三连按一次Esc进入普通模式然后输入:wq回车表示保存并退出。不想保存就:q!回车。如果觉得每次记这个太痛苦那就换个默认编辑器git config --global core.editor code --wait上面这条是在默认编辑器为 VS Code 的情况下使用的。如果你用的是 Notepad 之类的改成对应可执行文件路径就行。这种问题属于“一次性配置终生受益”的类型强烈建议装完 Git 就顺手设置。5.5 安装时 PATH 没选对之后怎么补救如果你装完发现 cmd 和 PowerShell 里敲不了git只能用 Git Bash那是因为安装向导里 PATH 没选“Git from the command line”。补救方案很简单Win11 搜索“编辑系统环境变量”打开“环境变量”窗口在“系统变量”里找到Path点击编辑新增两条C:\Program Files\Git\bin C:\Program Files\Git\cmd保存后重新打开终端git --version就能正常工作了。这两条路径的作用是让系统找到 Git 的各个可执行文件bin目录主要放的是 Git Bash 工具链里的命令cmd目录放的是git.exe和相关包装器。个人习惯上我一直建议把 Git 的基础配置和 SSH 密钥放在拿到新电脑的第一天就完成哪怕暂时没有代码要管。因为这一步一旦拖到“急需用的时候”再弄越急越容易在 SSH 密钥、换行符、右键菜单这些细节上反复横跳反而浪费更多时间。最后再分享一个小技巧在.gitconfig里加一个别名配置可以让日常操作快不少git config --global alias.st status git config --global alias.co checkout git config --global alias.br branch git config --global alias.cm commit -m配置完成后你就可以用git st代替git status用git cm 说明代替git commit -m 说明少敲几个字母手感顺滑很多。Git 的生态很庞大今天这些内容把最常见、最核心的部分覆盖到了等你在实际项目里真正跑起来再遇到问题记得先看一眼报错信息里的关键词大部分坑都是能搜到答案的。