2026 年Windows 上装 Git 这件事看起来简单实际坑一点不少。我见过太多人在下载页面里被一堆选项绕晕装到一半卡在 PATH 配置或者在第一次推送代码时被 Permission denied (publickey) 卡住一整天。这篇文章不是把官方文档翻译一遍也不是只教你怎么点下一步而是把我自己从零配置 Git 和 SSH 密钥这整套流程整理成一份可以直接照着做的清单。你只需要一台 Windows 电脑从下载安装到环境变量配置再到生成和绑定 SSH 密钥最后能正常 clone 和推送私有仓库整个过程大概 20 分钟。无论你是刚入行的前端、后端还是只在实验室里用 Git 交作业的学生这套流程都适用。下面这个版本是针对 2026 年最新的 Git for Windows 安装包重新实测过的每一步我都会说明为什么要这么做以及不做会踩什么坑。1. 准备开始前先把整条链路想清楚1.1 装 Git 只是第一步“能用”和“用得舒服”是两回事很多人以为下载一个 Git 安装包双击下一步就算装好了。其实这才刚走完前半段。装好 Git 之后你至少要面对三件事第一Windows 命令行能不能直接识别 git 命令第二Git 提交代码时用什么身份提交记录会显示谁的名字和邮箱第三哪天你要拉取 private 仓库或者推代码到远程平台怎么避免每次输密码。这三件事分别对应环境配置、用户配置和 SSH 密钥配置。环境配置解决的是“找不找得到程序”的问题用户配置解决的是“提交给谁”的问题SSH 密钥配置解决的是“身份是否可信”的问题。如果只装好 Git 但不做任何设置你会发现自己在终端里敲 git 的时候永远得到“不是内部或外部命令”或者第一次执行 git push 时被密码提醒搞得心烦意乱。Windows 上还有一个特殊点它不像 macOS 或 Linux 自带一套成熟的命令行生态。Git for Windows 提供了 Git Bash你可以把它理解成一个浓缩版的类 Unix 终端里面能用 ls、cd、vim 这类命令。这也意味着如果你习惯了 Linux 开发环境迁移成本会低很多。所以我这篇教程的默认终端就是 Git Bash不是 PowerShell也不是 CMD后面所有命令都尽量在 Git Bash 环境下执行。1.2 我把 SSH 密钥配置放进全套流程是因为它早晚躲不开很多教程把 Git 安装和 SSH 密钥分成两篇写其实这是不合理的。你第一次用 Git大概率就是去 clone 一个 GitHub 或公司 GitLab 项目。克隆地址通常会提供 HTTPS 和 SSH 两种方式。HTTPS 方式虽然看似简单但 2026 年的托管平台大多已经要求使用 token 代替密码token 有有效期过期之后你又要重新生成。SSH 方式则不用只要本机把公钥绑定到平台账号之后就可以通过密钥自动完成身份确认长期使用非常省心。更关键的是SSH 密钥代表你的设备身份不绑定某个具体网站账号。同一把公钥可以同时添加到 GitHub、GitLab、Gitee 这类平台。也就是说你只需要配置一次后面多平台都能通用。而且 SSH 密钥的私钥保存在本地公钥才上传到服务器从安全角度看私钥不离开本机比密码和 token 更可控。所以我把整条链路放在一起下载 Git、安装 Git、验证环境变量、配置用户信息、生成 SSH 密钥、绑定平台、测试连接。任何一个环节断了后面的 push 和 pull 都会出错。下面按顺序来你就可以从头到尾一次性装好。2. 下载前准备看清系统架构选对安装包2.1 先确认 Windows 是 64 位还是 32 位Git for Windows 官方安装包主要分 64 位和 32 位新版 Windows 系统 99% 都是 64 位但还是值得花十秒钟确认一下。你可以在 Windows 10 或 Windows 11 上打开“设置 → 系统 → 系统信息”在“系统类型”这一行能看到“基于 x64 的处理器”或“基于 ARM 的处理器”。如果是 Windows 11还可以点右键开始菜单选择“系统”然后看“设备规格”里的“系统类型”。如果显示 64 位操作系统、x64 处理器就直接下载 64 位版本。32 位版本只用于老设备2026 年已经很少见了我没有必要让你浪费时间去猜。另外如果你的电脑是 ARM 架构的 Windows比如部分新出的轻薄本或二合一设备Git for Windows 也提供了对应的 ARM64 安装包。下载时认准系统类型别拿 x64 的包去硬装到 ARM 设备上安装过程大概率会报“系统版本不匹配”。这一步虽然不起眼但它决定了后面所有步骤能不能顺利继续。2.2 官方下载地址和安装包命名怎么看Git for Windows 的官方下载页在 git-scm.com/download/win页面会根据你访问的设备自动推荐一个版本。但我不建议直接盲点那个大绿按钮先看页面下方的“64-bit Git for Windows Setup”这类链接。官方安装包的命名通常长这样Git-2.4x.x-64-bit.exeGit-2.4x.x-32-bit.exeGit-2.4x.x-arm64.exe中间的版本号会随时间更新可能你看到的是 2.50 或者更高。这不用担心Git 的版本迭代不会像某些软件那样频繁改交互逻辑安装流程非常稳定版本新一点只会修复更多 bug。下载完成后我还习惯做一步校验。虽然从官方域名下载基本不会出错但如果你是通过某些下载站跳转过来的就要小心。Git 官方安装包有没有校验值官方没有放出单独的哈希列表但你在实际安装时如果系统弹了 SmartScreen 警告需要注意程序内核是否可信。如果安装包是从官方来源直接下载一般双击之后不会有额外红色警告。最稳妥的做法是打开“文件属性 → 数字签名”确认签名者是“Git for Windows”或“Software Freedom Conservancy”。这一步耽误不到十秒钟却能避免装到改过包的恶意程序。3. 安装过程详解每一步都在改哪些关键配置3.1 安装向导中最需要认真看的 5 个选项Git 安装向导默认语言是英文中途有很多“Next”按钮但千万不要一路闭眼点到底尤其是下面这五个位置。第一个是“Select Components”选择组件。默认会勾选“Git Bash Here”和“Git GUI Here”这两个选项的意义是允许你在文件夹右键菜单里快速打开终端强烈建议保留。“Additional icons”里的“On the Desktop”建议取消桌面图标意义不大。还要注意“Git LFS”这个组件建议勾选。Git LFS 是大文件管理插件你早晚会 clone 到包含二进制大文件的仓库提前装好能省掉后面手动补装的麻烦。第二个是“Default editor used by Git”默认编辑器。默认是 Vim新手在 Vim 里写提交信息时很容易卡住不知道怎么退出。如果你不常改提交信息可以保持 Vim但至少要懂按一下 i 进入输入模式按一下 Esc再输入 :wq 保存退出。如果你希望更友好可以提前安装 Notepad 或 VS Code然后在这里选 Use Visual Studio Code 作为默认编辑器。我自己的习惯是用 VS Code因为提交信息写复杂备注时更直观不易误操作。第三个是“Adjusting your PATH environment”调整 PATH 环境变量。这可能是整个安装向导里最重要的一项有三个选项。第一个是“仅从 Git Bash 使用 Git”第二个是“从 Windows 命令行使用 Git”第三个是“从命令提示符使用 Git 及其 Unix 工具”。我的建议是选第二项也就是“Git from the command line and also from 3rd-party software”。这个选项会把 Git 的 cmd 目录加入系统 PATH让你在 PowerShell 和 CMD 里也能直接用 git。如果你只选第一项那么 PowerShell 里敲 git 就会提示找不到命令后面配置环境变量时还得自己手改。至于第三项它把大量 Unix 命令全部暴露给 Windows容易和系统自带命令冲突不建议选。第四个是“Checkout line endings conversion”行尾转换。默认选“Checkout Windows-style, commit Unix-style line endings”就好对应 core.autocrlftrue。Windows 默认换行符是 CRLFUnix 和 macOS 是 LF。如果不去处理多人协作仓库会出现整个文件被判定为全部修改的假象。这个默认值能在 checkout 时自动转回 CRLF在 commit 时自动转成 LF对 Windows 用户最友好。如果你接手的是纯 Unix 项目也可以改成第二项但新手阶段请保持默认。第五个是“Behavior of git pull”git pull 行为。默认是 fast-forward only 或 merge 方式我不建议在这里调整保持默认即可因为 git pull 具体策略完全可以用命令临时控制。安装向导最后还会问是否启用实验性功能默认不勾选建议不要勾选。你后面会发现Git 稳定版已经够用实验功能反而容易制造意外。3.2 安装完成后如何验证环境变量和 Git 可用安装完成后先别急着打开 VS Code 或直接 clone 项目。第一步是验证安装是否完整生效。打开一个 CMD 窗口或者直接按 Win R 输入 cmd先执行 git --version看能不能输出类似 git version 2.50.0.windows.1 这样的结果。如果命令提示找不到 git说明安装时 PATH 没有配好。你可以在“设置 → 系统 → 高级系统设置 → 环境变量”里检查 Path 用户变量是否包含 C:\Program Files\Git\cmd以及系统变量里是否也有对应条目。没有的话就手动添加然后重启终端窗口。第二步是在任意文件夹里点击右键确认菜单里有“Git Bash Here”和“Git GUI Here”顺手点开 Git Bash执行 pwd 看看当前路径。如果 Git Bash 能正常打开说明基本组件都装好了。第三步是检查是否自带 SSH 客户端。在 Git Bash 里执行 ssh -V如果输出 OpenSSH_for_Windows_9.x 或者类似版本说明 OpenSSH 客户端已经可用。Windows 10 1809 之后的系统自带 OpenSSH 客户端Git for Windows 也内置了 ssh.exe但为了确保后面生成密钥时用的是同一个 ssh-agent 服务我建议你在 Git Bash 里执行 which ssh确认路径指向 Git 自带的位置。这个细节在你后续配置 ssh-agent 时会很重要否则可能出现系统 OpenSSH 和 Git 内部 OpenSSH 调用混乱的情况。4. 环境配置实战把 Git 调成顺手的状态4.1 配置用户名和邮箱先搞清楚全局和仓库级别的区别安装完成后Git 不知道你是谁。你提交代码时提交记录里需要作者姓名和邮箱。执行以下两条命令git config --global user.name 你的名字 git config --global user.email 你的邮箱这里的 --global 表示全局配置会写入当前用户目录下的 .gitconfig 文件。没有加 --global 的话配置只作用于当前仓库保存在仓库目录下的 .git/config 里。实际工作中我会建议先设全局配置如果你在某个特定项目里想用另一个身份再单独在仓库目录执行不带 --global 的相同命令覆盖。有个小细节邮箱最好用你注册托管平台时使用的邮箱这样提交记录能正确关联到你的账号。如果邮箱不一致GitHub 后台虽然可以通过 Author email 自动关联但关联失败的情况也经常出现。如果希望严格隐藏邮箱托管平台也提供 noreply 邮箱那就用它来代替真实邮箱规则随平台不同略有差异通常可以在账号设置里找到。配置完之后执行 git config --global --list能看到 global 配置完整列表。这个命令会把你设置的 user.name、user.email 都显示出来。如果你怀疑某条配置写错了可以执行 git config --global --unset user.name 删除单条配置再重新设置。4.2 编辑器、换行符、默认分支和缓存配置的取舍用户名邮箱只是最基础的一项下面这几个属于“装好后顺手调优”的项目。第一个是默认编辑器。在上面安装阶段已经选过如果还想改可以用命令git config --global core.editor code --wait这条命令会使用 VS Code 作为 Git 的默认编辑器缺点是要求你已经把 code 命令加入 PATH。如果你用 Notepad可以写成git config --global core.editor C:/Program Files/Notepad/notepad.exe -multiInst -notabbar这块不是必须的但会直接影响提交信息编辑体验我建议优先配置成你熟悉的工具而不是 Vim。第二个是换行符。安装阶段已经选了 core.autocrlftrue命令行再确认一下git config --global core.autocrlf true如果仓库里已经存在大量涉及换行的冲突你可以临时关闭转换但不能把它当作长期方案否则跨平台仓库会很难看。同样的如果你只维护纯 Windows 项目且团队都是 Windows也可以用 false但保险起见默认 true 更省心。第三个是默认分支名。新版 Git 安装向导默认会让你选初始分支是 main 还是 master如果你已经装好了又忘了当时选的什么可以执行git config --global init.defaultBranch main这个设置影响的是 git init 时创建的分支名。现在新仓库基本统一用 main老项目仓库分支可能叫 master这个配置不影响已有仓库。第四个是 Git 默认缓冲区设置。如果你经常 clone 大仓库可以适当增加 http.postBuffergit config --global http.postBuffer 524288000这个值单位是字节524288000 对应当前网络上常见的大仓库克隆场景对于部分上传大文件时报错“RPC failed”的情况会有帮助。不过它不是万能的如果网络本身不稳定调大 buffer 也只是缓解。4.3 常用 Git 命令速查与配置检查配置完成后我建议你先把下面这些基础命令过一遍也算验证配置是否正确。git init # 初始化仓库 git status # 查看工作区状态 git add . # 暂存所有改动 git commit -m 提交说明 # 提交暂存区 git log --oneline # 查看提交历史 git branch -M main # 重命名当前分支为 main git remote add origin 地址 # 关联远程仓库 git push -u origin main # 推送并设置上游分支 git pull origin main # 拉取远程代码这些命令我整理成一张速查表给初学者贴在终端旁边参考命令作用高频使用场景git status查看工作区和暂存区状态每次操作前确认哪些文件改了git diff查看未暂存的具体改动提交前检查代码git log --oneline查看简洁提交历史快速找回某个提交git remote -v查看远程仓库地址确认当前仓库指向哪个网址git branch -a查看本地和远程全部分支查看仓库分支结构git stash暂存未提交工作区临时切换分支又不想丢失改动git reset --hard HEAD回退到最近一次提交放弃本地全部改动慎用git fetch --prune拉取远端新引用并清理过期分支同步远端分支列表我不建议大家一开始就死记硬背。常用程度最高的是 status、add、commit、push、pull其他命令遇到场景再查就行。重点是你先把前面所有配置命令执行成功再去碰仓库操作这样后面出错的原因可以和你自己的配置隔离开。5. SSH 密钥生成与配置让 git push 不再输密码5.1 生成密钥前的准备算法选择和参数理解SSH 密钥的核心是生成一对公钥和私钥。公钥放在托管平台上私钥留在本地。推送代码时平台用公钥验证你的签名如果你本地的私钥匹配就允许访问你账号下有权限的仓库。2026 年的主流推荐算法是 Ed25519它是一种基于椭圆曲线的签名算法密钥长度短安全性强性能也比 RSA 高。绝大多数现代平台都支持。如果遇到很老的 Git 服务器可能只支持 RSA那就用 RSA 并设置 4096 位长度。下面我以 Ed25519 为例。生成密钥前先检查自己有没有生成过ls -la ~/.ssh如果里面已经有 id_ed25519 和 id_ed25519.pub 这类文件说明之前生成过。这时要小心不要重复生成覆盖旧密钥否则你原来绑定到平台上的身份就失效了。你可以用旧密钥也可以备份后重新生成。还有一点需要提前理解SSH 密钥可以设置 passphrase口令。它不是密码而是用来加密私钥文件的密钥。设置 passphrase 之后每次使用私钥时都可能要求输入一遍。如果不设置私钥文件直接保存私钥内容任何拿到私钥文件的人都能冒充你。我建议首次配置时设置一个方便记忆的 passphrase并配合 ssh-agent 缓存后面就不用每次输入了。5.2 使用 Git Bash 生成 ed25519 密钥并配置 ssh-agent先在开始菜单找到 Git Bash或者在任意文件夹右键选择 Git Bash Here。然后执行ssh-keygen -t ed25519 -C 你的邮箱或备注-C 后面加的是注释通常写你的邮箱也可以写“work-laptop”这种便于识别的备注。它会显示Generating public/private ed25519 key pair. Enter file in which to save the key (/c/Users/你的用户名/.ssh/id_ed25519):直接回车表示使用默认路径。接着提示Enter passphrase (empty for no passphrase):这里输入你想设置的私钥口令。输入时不显示任何内容并不是卡住了直接盲打后按回车系统会让你再输入一次确认。生成成功后会在 ~/.ssh 下出现两个文件id_ed25519私钥绝对不要发给任何人id_ed25519.pub公钥可以添加到托管平台查看公钥内容使用cat ~/.ssh/id_ed25519.pub输出结果以 ssh-ed25519 开头后面是一长串加密字符最后是你填写的注释。推荐顺手配置 ssh-agent避免每次 push 都要输入 passphrase。在 Git Bash 中执行eval $(ssh-agent -s) ssh-add ~/.ssh/id_ed25519eval 这条会在当前终端启动 ssh-agent 并设置环境变量。ssh-add 则把私钥加载到 agent 中。如果私钥设置了 passphrase此时会遇到一次输入提示输入一次后在当前 agent 存活期间就不用重复输入了。如果你的 Windows 系统自带 OpenSSH 服务已经启动可能会看到“agent already running”或连接 socket 报错。这种情况可以改用exec ssh-agent bash ssh-add ~/.ssh/id_ed25519更彻底的方法是把 Git 自带的 ssh 路径提前确保 which ssh 指向 /usr/bin/ssh 而不是 C:\Windows\System32\OpenSSH\ssh.exe。Windows 自带的 OpenSSH 也可以用来生成密钥但 agent 管理方式在 Git Bash 里经常出现环境变量不互通的问题。为了避免这类玄学问题最简单的方法就是统一用 Git Bash 内置的 ssh 工具。5.3 添加公钥到托管平台并测试连通拿到公钥内容后去托管平台添加。以 GitHub 为例登录后进入 Settings → SSH and GPG keys → New SSH key。Title 可以写“ThinkPad-2026”也可以写“办公电脑”这是给你自己看的标识。Key type 选择 Authentication Key然后把 id_ed25519.pub 的内容完整粘贴到输入框。其他 GitLab 或 Gitee 平台也有类似的 SSH Keys 设置入口一般在用户头像菜单 - Preferences - SSH Keys或者 Settings - SSH Keys粘贴方式相同。添加完成后测试连接ssh -T gitgithub.com如果是 GitHub会提示你确认主机指纹The authenticity of host github.com (ip地址) cant be established. ED25519 key fingerprint is SHA256:DiY3wvvV6TuJJhbpZisF/zLDA0zPehi23l03Q. Are you sure you want to continue connecting (yes/no)?这里输入 yes然后回车。看到Hi 你的用户名! Youve successfully authenticated, but GitHub does not provide shell access.说明密钥已经生效。GitLab 通常输出Welcome to GitLab, 你的用户名!测试成功后以后 clone 仓库建议选择 SSH 地址gitgithub.com:用户名/仓库名.git不再是 https 开头也不需要 token 或密码。5.4 多账户场景通过 config 文件管理多个密钥如果你有多套身份比如一个工作账号和一个个人账号都绑定在同一台电脑上只生成一把默认密钥显然不够。解决办法是生成多把密钥然后利用 ~/.ssh/config 文件按域名指定。先分别生成个人和工作密钥ssh-keygen -t ed25519 -C personal -f ~/.ssh/id_ed25519_personal ssh-keygen -t ed25519 -C work -f ~/.ssh/id_ed25519_work然后编辑 ~/.ssh/config。如果文件不存在就新建Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519_personal Host gitlab.work.com HostName gitlab.work.com User git IdentityFile ~/.ssh/id_ed25519_work这里 Host 后面的别名非常关键。如果你给工作 GitLab 起的 Host 是 gitlab.work.com那么 clone 的地址也应该写成 gitgitlab.work.com:group/repo.git这样 SSH 才会自动匹配到对应的 IdentityFile。一旦 Host 和实际访问域名不一致SSH 会使用默认密钥导致权限失败。测试时分别写ssh -T gitgithub.com ssh -T gitgitlab.work.com看返回的用户名是否对应正确。多账户场景里我一般会给每个身份单独加一条注释在公钥文件名上方便以后查看。不过也要注意密钥文件多了一定要把私钥权限管理好。Windows 下可以右键文件 - 属性 - 安全把访问用户限制为当前管理员或当前用户避免其他本地账户随便读取。6. 常见问题与排查技巧实录6.1 高频报错速查表把我在实际答疑中遇到的报错整理成了一目了然的表格建议直接收藏报错提示可能原因解决方法git 不是内部或外部命令PATH 没配好检查环境变量是否包含 Git\cmd重启终端Permission denied (publickey)公钥未添加、私钥未加载或身份不匹配确认 ssh-add -l 有密钥检查平台公钥是否粘贴完整Could not open a connection to your authentication agentssh-agent 未启动在 Git Bash 执行 eval $(ssh-agent -s)The authenticity of host ... cant be established首次连接陌生主机输入 yes 并核对指纹Remote host identification has changedknown_hosts 中的旧指纹与服务器不一致删除 ~/.ssh/known_hosts 中对应行后重连fatal: not a git repository当前目录不是 Git 仓库先执行 git init 或进入正确的仓库目录fatal: unable to access ... Failed to connect网络问题或代理设置残留用远程仓库地址的连通性测试对照 ssh -vT 输出检查指向warning: LF will be replaced by CRLF换行符转换警告属正常情况确认 core.autocrlf 配置是否符合预期最后一类问题我要专门说一句很多人的 SSH 测试失败不是因为平台配置错而是因为之前把系统代理等设置写进了 Git 全局配置。你可以用 git config --global --list 查看是否有 http.proxy 或 https.proxy 残留如果有别急着删先确认是不是你主动设置的。如果不需要再单独卸载git config --global --unset http.proxy git config --global --unset https.proxy这种残留通常出现在你曾经更换过网络环境或迁移过配置文件的电脑上。6.2 排查 SSH 问题的系统性思路遇到 SSH 连不上时不要一直试同一个测试命令那只会得到同样报错。我的排查顺序是这样先看密钥是否被加载执行 ssh-add -l如果输出 The agent has no identities说明私钥没进入 agent回到 5.2 步重新 ssh-add。再看公钥是否贴对去平台把已存在的密钥和本地 id_ed25519.pub 内容逐字符比对尤其注意有没有多出空格或遗漏回车。接着看测试命令的 verbose 输出ssh -vT gitgithub.com-v 参数会把连接过程中的握手细节全部打印出来。重点看最后几行如果出现debug1: Offering public key: /c/Users/xxx/.ssh/id_ed25519说明 SSH 已尝试用这个密钥紧接着如果还是权限拒绝重点就转向平台端。如果根本没出现 Offering public key说明 config 里 IdentityFile 指错了位置或者 ssh-agent 没加载这把私钥。还要注意一点Windows 的用户目录可能有多个账户环境不同终端窗口可能加载了不同的 HOME 环境变量导致 ~/.ssh 指向的位置看起来一致实际却不是同一个目录。Git Bash 里执行 echo $HOME确认路径是你预期的用户名目录。如果 HOME 被改过及时修正。6.3 安装和配置中的几个独家避坑经验最后分享几个我踩过好几次的坑都是官方文档里不会花篇幅写的。第一个Git Bash 里复制粘贴快捷键和 Windows 不一样。CtrlC 在终端里是中断命令不是复制。复制用鼠标选中内容后右键或 CtrlInsert粘贴用 ShiftInsert 或右键菜单。新手很容易在输入 passphrase 时误按 CtrlC 中断生成流程。第二个粘贴公钥时一定要留意 .pub 文件后缀。很多人复制的时候不小心复制了 id_ed25519 也就是私钥内容不但平台校验失败还会把自己私钥泄露到网页粘贴记录里。分辨方法很简单公钥内容开头是 ssh-ed25519开头带 BEGIN OPENSSH PRIVATE KEY 的就是私钥绝对不能贴到平台。第三个执行 git clone 时如果把仓库放到 OneDrive、坚果云等同步盘目录下同步盘会和 Git 的临时文件产生冲突经常出现奇怪的 permission denied 或索引损坏。Git 是分布式的本地仓库文件最好不要放进自动同步目录宁可放到专门的代码目录手动备份也更有把握。第四个如果在公司电脑用 Git并且平台是公司自建的 GitLab 或 Gitea域名是内网地址时known_hosts 指纹可能随服务器证书更新而变化。碰到 Remote host identification has changed别急着全删 known_hosts先用 ssh-keygen -R 域名 移除对应主机的旧记录再重新连接即可这样可以保留其他主机的指纹记录。第五个Git for Windows 每年都会更新但不需要追最新版本。只要当前版本没有遇到 bug就不必频繁升级。升级前最好看一眼 release notes因为一旦 Git 内部行为改变比如默认分支名或证书校验规则调整长期不更新的人容易在跨境协作仓库里遇到异常。这套流程走完你的 Windows 开发环境里Git 基本就是可长期使用的状态。我记得自己第一次处理 SSH 密钥时因为不理解 agent 机制反复报错到差点放弃。后来想通了整条链路才明白每一步都在解决一个独立问题。如果你在配置过程中卡在某一步先停下来确认自己当前卡在哪一层是程序找不到、身份没设置、密钥没加载、还是平台没绑定。把这四个点分开排查绝大部分问题都能在三分钟内定位。我个人实际用下来还有一个习惯就是没事会跑一次 git config --global --list 和 ssh-add -l 快速检查环境和密钥状态。这不需要花多少时间但能让你在下次遇到奇怪报错时第一时间排除配置层的问题。
2026 年Windows 上装 Git 这件事看起来简单实际坑一点不少。我见过太多人在下载页面里被一堆选项绕晕装到一半卡在 PATH 配置或者在第一次推送代码时被 Permission denied (publickey) 卡住一整天。这篇文章不是把官方文档翻译一遍也不是只教你怎么点下一步而是把我自己从零配置 Git 和 SSH 密钥这整套流程整理成一份可以直接照着做的清单。你只需要一台 Windows 电脑从下载安装到环境变量配置再到生成和绑定 SSH 密钥最后能正常 clone 和推送私有仓库整个过程大概 20 分钟。无论你是刚入行的前端、后端还是只在实验室里用 Git 交作业的学生这套流程都适用。下面这个版本是针对 2026 年最新的 Git for Windows 安装包重新实测过的每一步我都会说明为什么要这么做以及不做会踩什么坑。1. 准备开始前先把整条链路想清楚1.1 装 Git 只是第一步“能用”和“用得舒服”是两回事很多人以为下载一个 Git 安装包双击下一步就算装好了。其实这才刚走完前半段。装好 Git 之后你至少要面对三件事第一Windows 命令行能不能直接识别 git 命令第二Git 提交代码时用什么身份提交记录会显示谁的名字和邮箱第三哪天你要拉取 private 仓库或者推代码到远程平台怎么避免每次输密码。这三件事分别对应环境配置、用户配置和 SSH 密钥配置。环境配置解决的是“找不找得到程序”的问题用户配置解决的是“提交给谁”的问题SSH 密钥配置解决的是“身份是否可信”的问题。如果只装好 Git 但不做任何设置你会发现自己在终端里敲 git 的时候永远得到“不是内部或外部命令”或者第一次执行 git push 时被密码提醒搞得心烦意乱。Windows 上还有一个特殊点它不像 macOS 或 Linux 自带一套成熟的命令行生态。Git for Windows 提供了 Git Bash你可以把它理解成一个浓缩版的类 Unix 终端里面能用 ls、cd、vim 这类命令。这也意味着如果你习惯了 Linux 开发环境迁移成本会低很多。所以我这篇教程的默认终端就是 Git Bash不是 PowerShell也不是 CMD后面所有命令都尽量在 Git Bash 环境下执行。1.2 我把 SSH 密钥配置放进全套流程是因为它早晚躲不开很多教程把 Git 安装和 SSH 密钥分成两篇写其实这是不合理的。你第一次用 Git大概率就是去 clone 一个 GitHub 或公司 GitLab 项目。克隆地址通常会提供 HTTPS 和 SSH 两种方式。HTTPS 方式虽然看似简单但 2026 年的托管平台大多已经要求使用 token 代替密码token 有有效期过期之后你又要重新生成。SSH 方式则不用只要本机把公钥绑定到平台账号之后就可以通过密钥自动完成身份确认长期使用非常省心。更关键的是SSH 密钥代表你的设备身份不绑定某个具体网站账号。同一把公钥可以同时添加到 GitHub、GitLab、Gitee 这类平台。也就是说你只需要配置一次后面多平台都能通用。而且 SSH 密钥的私钥保存在本地公钥才上传到服务器从安全角度看私钥不离开本机比密码和 token 更可控。所以我把整条链路放在一起下载 Git、安装 Git、验证环境变量、配置用户信息、生成 SSH 密钥、绑定平台、测试连接。任何一个环节断了后面的 push 和 pull 都会出错。下面按顺序来你就可以从头到尾一次性装好。2. 下载前准备看清系统架构选对安装包2.1 先确认 Windows 是 64 位还是 32 位Git for Windows 官方安装包主要分 64 位和 32 位新版 Windows 系统 99% 都是 64 位但还是值得花十秒钟确认一下。你可以在 Windows 10 或 Windows 11 上打开“设置 → 系统 → 系统信息”在“系统类型”这一行能看到“基于 x64 的处理器”或“基于 ARM 的处理器”。如果是 Windows 11还可以点右键开始菜单选择“系统”然后看“设备规格”里的“系统类型”。如果显示 64 位操作系统、x64 处理器就直接下载 64 位版本。32 位版本只用于老设备2026 年已经很少见了我没有必要让你浪费时间去猜。另外如果你的电脑是 ARM 架构的 Windows比如部分新出的轻薄本或二合一设备Git for Windows 也提供了对应的 ARM64 安装包。下载时认准系统类型别拿 x64 的包去硬装到 ARM 设备上安装过程大概率会报“系统版本不匹配”。这一步虽然不起眼但它决定了后面所有步骤能不能顺利继续。2.2 官方下载地址和安装包命名怎么看Git for Windows 的官方下载页在 git-scm.com/download/win页面会根据你访问的设备自动推荐一个版本。但我不建议直接盲点那个大绿按钮先看页面下方的“64-bit Git for Windows Setup”这类链接。官方安装包的命名通常长这样Git-2.4x.x-64-bit.exeGit-2.4x.x-32-bit.exeGit-2.4x.x-arm64.exe中间的版本号会随时间更新可能你看到的是 2.50 或者更高。这不用担心Git 的版本迭代不会像某些软件那样频繁改交互逻辑安装流程非常稳定版本新一点只会修复更多 bug。下载完成后我还习惯做一步校验。虽然从官方域名下载基本不会出错但如果你是通过某些下载站跳转过来的就要小心。Git 官方安装包有没有校验值官方没有放出单独的哈希列表但你在实际安装时如果系统弹了 SmartScreen 警告需要注意程序内核是否可信。如果安装包是从官方来源直接下载一般双击之后不会有额外红色警告。最稳妥的做法是打开“文件属性 → 数字签名”确认签名者是“Git for Windows”或“Software Freedom Conservancy”。这一步耽误不到十秒钟却能避免装到改过包的恶意程序。3. 安装过程详解每一步都在改哪些关键配置3.1 安装向导中最需要认真看的 5 个选项Git 安装向导默认语言是英文中途有很多“Next”按钮但千万不要一路闭眼点到底尤其是下面这五个位置。第一个是“Select Components”选择组件。默认会勾选“Git Bash Here”和“Git GUI Here”这两个选项的意义是允许你在文件夹右键菜单里快速打开终端强烈建议保留。“Additional icons”里的“On the Desktop”建议取消桌面图标意义不大。还要注意“Git LFS”这个组件建议勾选。Git LFS 是大文件管理插件你早晚会 clone 到包含二进制大文件的仓库提前装好能省掉后面手动补装的麻烦。第二个是“Default editor used by Git”默认编辑器。默认是 Vim新手在 Vim 里写提交信息时很容易卡住不知道怎么退出。如果你不常改提交信息可以保持 Vim但至少要懂按一下 i 进入输入模式按一下 Esc再输入 :wq 保存退出。如果你希望更友好可以提前安装 Notepad 或 VS Code然后在这里选 Use Visual Studio Code 作为默认编辑器。我自己的习惯是用 VS Code因为提交信息写复杂备注时更直观不易误操作。第三个是“Adjusting your PATH environment”调整 PATH 环境变量。这可能是整个安装向导里最重要的一项有三个选项。第一个是“仅从 Git Bash 使用 Git”第二个是“从 Windows 命令行使用 Git”第三个是“从命令提示符使用 Git 及其 Unix 工具”。我的建议是选第二项也就是“Git from the command line and also from 3rd-party software”。这个选项会把 Git 的 cmd 目录加入系统 PATH让你在 PowerShell 和 CMD 里也能直接用 git。如果你只选第一项那么 PowerShell 里敲 git 就会提示找不到命令后面配置环境变量时还得自己手改。至于第三项它把大量 Unix 命令全部暴露给 Windows容易和系统自带命令冲突不建议选。第四个是“Checkout line endings conversion”行尾转换。默认选“Checkout Windows-style, commit Unix-style line endings”就好对应 core.autocrlftrue。Windows 默认换行符是 CRLFUnix 和 macOS 是 LF。如果不去处理多人协作仓库会出现整个文件被判定为全部修改的假象。这个默认值能在 checkout 时自动转回 CRLF在 commit 时自动转成 LF对 Windows 用户最友好。如果你接手的是纯 Unix 项目也可以改成第二项但新手阶段请保持默认。第五个是“Behavior of git pull”git pull 行为。默认是 fast-forward only 或 merge 方式我不建议在这里调整保持默认即可因为 git pull 具体策略完全可以用命令临时控制。安装向导最后还会问是否启用实验性功能默认不勾选建议不要勾选。你后面会发现Git 稳定版已经够用实验功能反而容易制造意外。3.2 安装完成后如何验证环境变量和 Git 可用安装完成后先别急着打开 VS Code 或直接 clone 项目。第一步是验证安装是否完整生效。打开一个 CMD 窗口或者直接按 Win R 输入 cmd先执行 git --version看能不能输出类似 git version 2.50.0.windows.1 这样的结果。如果命令提示找不到 git说明安装时 PATH 没有配好。你可以在“设置 → 系统 → 高级系统设置 → 环境变量”里检查 Path 用户变量是否包含 C:\Program Files\Git\cmd以及系统变量里是否也有对应条目。没有的话就手动添加然后重启终端窗口。第二步是在任意文件夹里点击右键确认菜单里有“Git Bash Here”和“Git GUI Here”顺手点开 Git Bash执行 pwd 看看当前路径。如果 Git Bash 能正常打开说明基本组件都装好了。第三步是检查是否自带 SSH 客户端。在 Git Bash 里执行 ssh -V如果输出 OpenSSH_for_Windows_9.x 或者类似版本说明 OpenSSH 客户端已经可用。Windows 10 1809 之后的系统自带 OpenSSH 客户端Git for Windows 也内置了 ssh.exe但为了确保后面生成密钥时用的是同一个 ssh-agent 服务我建议你在 Git Bash 里执行 which ssh确认路径指向 Git 自带的位置。这个细节在你后续配置 ssh-agent 时会很重要否则可能出现系统 OpenSSH 和 Git 内部 OpenSSH 调用混乱的情况。4. 环境配置实战把 Git 调成顺手的状态4.1 配置用户名和邮箱先搞清楚全局和仓库级别的区别安装完成后Git 不知道你是谁。你提交代码时提交记录里需要作者姓名和邮箱。执行以下两条命令git config --global user.name 你的名字 git config --global user.email 你的邮箱这里的 --global 表示全局配置会写入当前用户目录下的 .gitconfig 文件。没有加 --global 的话配置只作用于当前仓库保存在仓库目录下的 .git/config 里。实际工作中我会建议先设全局配置如果你在某个特定项目里想用另一个身份再单独在仓库目录执行不带 --global 的相同命令覆盖。有个小细节邮箱最好用你注册托管平台时使用的邮箱这样提交记录能正确关联到你的账号。如果邮箱不一致GitHub 后台虽然可以通过 Author email 自动关联但关联失败的情况也经常出现。如果希望严格隐藏邮箱托管平台也提供 noreply 邮箱那就用它来代替真实邮箱规则随平台不同略有差异通常可以在账号设置里找到。配置完之后执行 git config --global --list能看到 global 配置完整列表。这个命令会把你设置的 user.name、user.email 都显示出来。如果你怀疑某条配置写错了可以执行 git config --global --unset user.name 删除单条配置再重新设置。4.2 编辑器、换行符、默认分支和缓存配置的取舍用户名邮箱只是最基础的一项下面这几个属于“装好后顺手调优”的项目。第一个是默认编辑器。在上面安装阶段已经选过如果还想改可以用命令git config --global core.editor code --wait这条命令会使用 VS Code 作为 Git 的默认编辑器缺点是要求你已经把 code 命令加入 PATH。如果你用 Notepad可以写成git config --global core.editor C:/Program Files/Notepad/notepad.exe -multiInst -notabbar这块不是必须的但会直接影响提交信息编辑体验我建议优先配置成你熟悉的工具而不是 Vim。第二个是换行符。安装阶段已经选了 core.autocrlftrue命令行再确认一下git config --global core.autocrlf true如果仓库里已经存在大量涉及换行的冲突你可以临时关闭转换但不能把它当作长期方案否则跨平台仓库会很难看。同样的如果你只维护纯 Windows 项目且团队都是 Windows也可以用 false但保险起见默认 true 更省心。第三个是默认分支名。新版 Git 安装向导默认会让你选初始分支是 main 还是 master如果你已经装好了又忘了当时选的什么可以执行git config --global init.defaultBranch main这个设置影响的是 git init 时创建的分支名。现在新仓库基本统一用 main老项目仓库分支可能叫 master这个配置不影响已有仓库。第四个是 Git 默认缓冲区设置。如果你经常 clone 大仓库可以适当增加 http.postBuffergit config --global http.postBuffer 524288000这个值单位是字节524288000 对应当前网络上常见的大仓库克隆场景对于部分上传大文件时报错“RPC failed”的情况会有帮助。不过它不是万能的如果网络本身不稳定调大 buffer 也只是缓解。4.3 常用 Git 命令速查与配置检查配置完成后我建议你先把下面这些基础命令过一遍也算验证配置是否正确。git init # 初始化仓库 git status # 查看工作区状态 git add . # 暂存所有改动 git commit -m 提交说明 # 提交暂存区 git log --oneline # 查看提交历史 git branch -M main # 重命名当前分支为 main git remote add origin 地址 # 关联远程仓库 git push -u origin main # 推送并设置上游分支 git pull origin main # 拉取远程代码这些命令我整理成一张速查表给初学者贴在终端旁边参考命令作用高频使用场景git status查看工作区和暂存区状态每次操作前确认哪些文件改了git diff查看未暂存的具体改动提交前检查代码git log --oneline查看简洁提交历史快速找回某个提交git remote -v查看远程仓库地址确认当前仓库指向哪个网址git branch -a查看本地和远程全部分支查看仓库分支结构git stash暂存未提交工作区临时切换分支又不想丢失改动git reset --hard HEAD回退到最近一次提交放弃本地全部改动慎用git fetch --prune拉取远端新引用并清理过期分支同步远端分支列表我不建议大家一开始就死记硬背。常用程度最高的是 status、add、commit、push、pull其他命令遇到场景再查就行。重点是你先把前面所有配置命令执行成功再去碰仓库操作这样后面出错的原因可以和你自己的配置隔离开。5. SSH 密钥生成与配置让 git push 不再输密码5.1 生成密钥前的准备算法选择和参数理解SSH 密钥的核心是生成一对公钥和私钥。公钥放在托管平台上私钥留在本地。推送代码时平台用公钥验证你的签名如果你本地的私钥匹配就允许访问你账号下有权限的仓库。2026 年的主流推荐算法是 Ed25519它是一种基于椭圆曲线的签名算法密钥长度短安全性强性能也比 RSA 高。绝大多数现代平台都支持。如果遇到很老的 Git 服务器可能只支持 RSA那就用 RSA 并设置 4096 位长度。下面我以 Ed25519 为例。生成密钥前先检查自己有没有生成过ls -la ~/.ssh如果里面已经有 id_ed25519 和 id_ed25519.pub 这类文件说明之前生成过。这时要小心不要重复生成覆盖旧密钥否则你原来绑定到平台上的身份就失效了。你可以用旧密钥也可以备份后重新生成。还有一点需要提前理解SSH 密钥可以设置 passphrase口令。它不是密码而是用来加密私钥文件的密钥。设置 passphrase 之后每次使用私钥时都可能要求输入一遍。如果不设置私钥文件直接保存私钥内容任何拿到私钥文件的人都能冒充你。我建议首次配置时设置一个方便记忆的 passphrase并配合 ssh-agent 缓存后面就不用每次输入了。5.2 使用 Git Bash 生成 ed25519 密钥并配置 ssh-agent先在开始菜单找到 Git Bash或者在任意文件夹右键选择 Git Bash Here。然后执行ssh-keygen -t ed25519 -C 你的邮箱或备注-C 后面加的是注释通常写你的邮箱也可以写“work-laptop”这种便于识别的备注。它会显示Generating public/private ed25519 key pair. Enter file in which to save the key (/c/Users/你的用户名/.ssh/id_ed25519):直接回车表示使用默认路径。接着提示Enter passphrase (empty for no passphrase):这里输入你想设置的私钥口令。输入时不显示任何内容并不是卡住了直接盲打后按回车系统会让你再输入一次确认。生成成功后会在 ~/.ssh 下出现两个文件id_ed25519私钥绝对不要发给任何人id_ed25519.pub公钥可以添加到托管平台查看公钥内容使用cat ~/.ssh/id_ed25519.pub输出结果以 ssh-ed25519 开头后面是一长串加密字符最后是你填写的注释。推荐顺手配置 ssh-agent避免每次 push 都要输入 passphrase。在 Git Bash 中执行eval $(ssh-agent -s) ssh-add ~/.ssh/id_ed25519eval 这条会在当前终端启动 ssh-agent 并设置环境变量。ssh-add 则把私钥加载到 agent 中。如果私钥设置了 passphrase此时会遇到一次输入提示输入一次后在当前 agent 存活期间就不用重复输入了。如果你的 Windows 系统自带 OpenSSH 服务已经启动可能会看到“agent already running”或连接 socket 报错。这种情况可以改用exec ssh-agent bash ssh-add ~/.ssh/id_ed25519更彻底的方法是把 Git 自带的 ssh 路径提前确保 which ssh 指向 /usr/bin/ssh 而不是 C:\Windows\System32\OpenSSH\ssh.exe。Windows 自带的 OpenSSH 也可以用来生成密钥但 agent 管理方式在 Git Bash 里经常出现环境变量不互通的问题。为了避免这类玄学问题最简单的方法就是统一用 Git Bash 内置的 ssh 工具。5.3 添加公钥到托管平台并测试连通拿到公钥内容后去托管平台添加。以 GitHub 为例登录后进入 Settings → SSH and GPG keys → New SSH key。Title 可以写“ThinkPad-2026”也可以写“办公电脑”这是给你自己看的标识。Key type 选择 Authentication Key然后把 id_ed25519.pub 的内容完整粘贴到输入框。其他 GitLab 或 Gitee 平台也有类似的 SSH Keys 设置入口一般在用户头像菜单 - Preferences - SSH Keys或者 Settings - SSH Keys粘贴方式相同。添加完成后测试连接ssh -T gitgithub.com如果是 GitHub会提示你确认主机指纹The authenticity of host github.com (ip地址) cant be established. ED25519 key fingerprint is SHA256:DiY3wvvV6TuJJhbpZisF/zLDA0zPehi23l03Q. Are you sure you want to continue connecting (yes/no)?这里输入 yes然后回车。看到Hi 你的用户名! Youve successfully authenticated, but GitHub does not provide shell access.说明密钥已经生效。GitLab 通常输出Welcome to GitLab, 你的用户名!测试成功后以后 clone 仓库建议选择 SSH 地址gitgithub.com:用户名/仓库名.git不再是 https 开头也不需要 token 或密码。5.4 多账户场景通过 config 文件管理多个密钥如果你有多套身份比如一个工作账号和一个个人账号都绑定在同一台电脑上只生成一把默认密钥显然不够。解决办法是生成多把密钥然后利用 ~/.ssh/config 文件按域名指定。先分别生成个人和工作密钥ssh-keygen -t ed25519 -C personal -f ~/.ssh/id_ed25519_personal ssh-keygen -t ed25519 -C work -f ~/.ssh/id_ed25519_work然后编辑 ~/.ssh/config。如果文件不存在就新建Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519_personal Host gitlab.work.com HostName gitlab.work.com User git IdentityFile ~/.ssh/id_ed25519_work这里 Host 后面的别名非常关键。如果你给工作 GitLab 起的 Host 是 gitlab.work.com那么 clone 的地址也应该写成 gitgitlab.work.com:group/repo.git这样 SSH 才会自动匹配到对应的 IdentityFile。一旦 Host 和实际访问域名不一致SSH 会使用默认密钥导致权限失败。测试时分别写ssh -T gitgithub.com ssh -T gitgitlab.work.com看返回的用户名是否对应正确。多账户场景里我一般会给每个身份单独加一条注释在公钥文件名上方便以后查看。不过也要注意密钥文件多了一定要把私钥权限管理好。Windows 下可以右键文件 - 属性 - 安全把访问用户限制为当前管理员或当前用户避免其他本地账户随便读取。6. 常见问题与排查技巧实录6.1 高频报错速查表把我在实际答疑中遇到的报错整理成了一目了然的表格建议直接收藏报错提示可能原因解决方法git 不是内部或外部命令PATH 没配好检查环境变量是否包含 Git\cmd重启终端Permission denied (publickey)公钥未添加、私钥未加载或身份不匹配确认 ssh-add -l 有密钥检查平台公钥是否粘贴完整Could not open a connection to your authentication agentssh-agent 未启动在 Git Bash 执行 eval $(ssh-agent -s)The authenticity of host ... cant be established首次连接陌生主机输入 yes 并核对指纹Remote host identification has changedknown_hosts 中的旧指纹与服务器不一致删除 ~/.ssh/known_hosts 中对应行后重连fatal: not a git repository当前目录不是 Git 仓库先执行 git init 或进入正确的仓库目录fatal: unable to access ... Failed to connect网络问题或代理设置残留用远程仓库地址的连通性测试对照 ssh -vT 输出检查指向warning: LF will be replaced by CRLF换行符转换警告属正常情况确认 core.autocrlf 配置是否符合预期最后一类问题我要专门说一句很多人的 SSH 测试失败不是因为平台配置错而是因为之前把系统代理等设置写进了 Git 全局配置。你可以用 git config --global --list 查看是否有 http.proxy 或 https.proxy 残留如果有别急着删先确认是不是你主动设置的。如果不需要再单独卸载git config --global --unset http.proxy git config --global --unset https.proxy这种残留通常出现在你曾经更换过网络环境或迁移过配置文件的电脑上。6.2 排查 SSH 问题的系统性思路遇到 SSH 连不上时不要一直试同一个测试命令那只会得到同样报错。我的排查顺序是这样先看密钥是否被加载执行 ssh-add -l如果输出 The agent has no identities说明私钥没进入 agent回到 5.2 步重新 ssh-add。再看公钥是否贴对去平台把已存在的密钥和本地 id_ed25519.pub 内容逐字符比对尤其注意有没有多出空格或遗漏回车。接着看测试命令的 verbose 输出ssh -vT gitgithub.com-v 参数会把连接过程中的握手细节全部打印出来。重点看最后几行如果出现debug1: Offering public key: /c/Users/xxx/.ssh/id_ed25519说明 SSH 已尝试用这个密钥紧接着如果还是权限拒绝重点就转向平台端。如果根本没出现 Offering public key说明 config 里 IdentityFile 指错了位置或者 ssh-agent 没加载这把私钥。还要注意一点Windows 的用户目录可能有多个账户环境不同终端窗口可能加载了不同的 HOME 环境变量导致 ~/.ssh 指向的位置看起来一致实际却不是同一个目录。Git Bash 里执行 echo $HOME确认路径是你预期的用户名目录。如果 HOME 被改过及时修正。6.3 安装和配置中的几个独家避坑经验最后分享几个我踩过好几次的坑都是官方文档里不会花篇幅写的。第一个Git Bash 里复制粘贴快捷键和 Windows 不一样。CtrlC 在终端里是中断命令不是复制。复制用鼠标选中内容后右键或 CtrlInsert粘贴用 ShiftInsert 或右键菜单。新手很容易在输入 passphrase 时误按 CtrlC 中断生成流程。第二个粘贴公钥时一定要留意 .pub 文件后缀。很多人复制的时候不小心复制了 id_ed25519 也就是私钥内容不但平台校验失败还会把自己私钥泄露到网页粘贴记录里。分辨方法很简单公钥内容开头是 ssh-ed25519开头带 BEGIN OPENSSH PRIVATE KEY 的就是私钥绝对不能贴到平台。第三个执行 git clone 时如果把仓库放到 OneDrive、坚果云等同步盘目录下同步盘会和 Git 的临时文件产生冲突经常出现奇怪的 permission denied 或索引损坏。Git 是分布式的本地仓库文件最好不要放进自动同步目录宁可放到专门的代码目录手动备份也更有把握。第四个如果在公司电脑用 Git并且平台是公司自建的 GitLab 或 Gitea域名是内网地址时known_hosts 指纹可能随服务器证书更新而变化。碰到 Remote host identification has changed别急着全删 known_hosts先用 ssh-keygen -R 域名 移除对应主机的旧记录再重新连接即可这样可以保留其他主机的指纹记录。第五个Git for Windows 每年都会更新但不需要追最新版本。只要当前版本没有遇到 bug就不必频繁升级。升级前最好看一眼 release notes因为一旦 Git 内部行为改变比如默认分支名或证书校验规则调整长期不更新的人容易在跨境协作仓库里遇到异常。这套流程走完你的 Windows 开发环境里Git 基本就是可长期使用的状态。我记得自己第一次处理 SSH 密钥时因为不理解 agent 机制反复报错到差点放弃。后来想通了整条链路才明白每一步都在解决一个独立问题。如果你在配置过程中卡在某一步先停下来确认自己当前卡在哪一层是程序找不到、身份没设置、密钥没加载、还是平台没绑定。把这四个点分开排查绝大部分问题都能在三分钟内定位。我个人实际用下来还有一个习惯就是没事会跑一次 git config --global --list 和 ssh-add -l 快速检查环境和密钥状态。这不需要花多少时间但能让你在下次遇到奇怪报错时第一时间排除配置层的问题。
