Windows下Git安装配置与SSH密钥设置全流程指南

我帮人配过无数套Windows上的Git环境，发现大多数人卡住的不是Git本身，而是安装时一堆英文选项不知道怎么选，以及后面SSH密钥配置时那几句报错看不懂。这篇文章直接把下载、安装、环境变量配置、基础配置、SSH密钥生成与测试全部串起来，全部以2026年当前官网最新版Git for Windows为基准，系统版本覆盖Windows 10和Windows 11。只要按步骤走，基本半小时内能搞定一套干净的Git开发环境。

1. 安装前的准备与核心思路

1.1 Git在Windows下的特殊之处

Git最初是为Linux这类Unix系统设计的，所以它默认的终端环境、路径分隔符、换行符等，都跟Windows本地习惯不太一样。Windows上安装Git，并不只是安装一个.exe文件那么简单，里面还包含了一个模拟Unix命令行的Git Bash、一个图形化工具Git GUI，以及一套与Windows集成紧密的凭据管理器。

很多新手会问：Windows不是有cmd和PowerShell吗，为什么还要专门装一个Git Bash？简单说，Git的很多命令和脚本都依赖Unix风格的命令行工具，比如ssh、grep、sed、cat这些。在PowerShell里虽然也能调用ssh，但Git目录下的各种自带工具链并不完整。Git Bash本质上是一个轻量级的MSYS2环境，把Git依赖的常用Unix工具都打好了包，专门为Git服务。所以，想省事就直接用Git Bash来执行Git命令，这也是后面所有操作的基础。

另外，Windows和Unix系统在文本文件的换行符处理上不一样，Windows用CRLF（回车加换行），Unix和Linux用LF（只换行）。如果处理不好，Git在提交代码时会提示整个文件都被修改，也就是常见的"warning: LF will be replaced by CRLF"。安装时有一个选项专门控制这个行为，后面我会详细讲。

1.2 安装前的系统检查与版本选择

在下载之前，先确认自己的Windows系统版本和系统架构。右键点击"此电脑"，选择"属性"，可以看到"系统类型"是64位还是32位操作系统。现在绝大多数电脑都是64位，但偶尔会遇到老旧机器或者轻量办公本还是32位，这时候需要选择对应的安装包。Git for Windows已经停止提供32位版本的官方安装包，如果真遇到32位系统，建议先升级系统，否则只能找旧版本，但旧版本存在安全漏洞，不建议使用。

确认系统架构后，还需要确认是否安装过其他版本的Git。有些人电脑里可能已经装过某些软件自带的简化版Git，比如部分编辑器或开发工具会捆绑Git。这种情况下最好先把旧版本卸载干净，再安装官方版本，避免PATH环境变量冲突，导致命令执行到旧版本。

另一个容易被忽略的点是磁盘权限。安装Git时需要对Program Files目录有写入权限，很多公司统一发的电脑没有管理员权限。建议提前联系管理员开通权限，或者安装到用户目录下。安装路径尽量不要带中文和空格，虽然Git本身能处理，但某些后续工具和脚本可能会因为路径里的中文或空格出问题。

2. Git下载与安装全流程

2.1 官方下载渠道与版本甄别

Git的官方下载页是git-scm.com/download/win。打开页面后，系统会自动识别平台，但如果识别不准确，可以手动下拉选择64-bit或32-bit版本。还有一个更直接的方法，就是进入Git的GitHub仓库的releases页面，找到最新稳定版，下载.exe格式的安装文件。

这里要注意区分稳定版和RC版本。RC是候选版本，功能基本确定但可能有少量遗留问题，普通用户不要碰。下载页面里一般会标出版本号，比如2.47.1这类，选带"Latest"标记的即可。网上有些第三方下载站也提供Git安装包，但我不太建议用，因为你不知道对方是否修改过安装包，Git本身是安全工具，泄露或篡改风险不值得冒险。官网下载慢的话，国内用户可以使用一些知名的软件镜像站，但一定要认准可靠的来源。

下载完成后，先不要急着双击，右键安装包选择"以管理员身份运行"，保证安装过程有足够权限。如果你的浏览器提示SmartScreen筛选器阻止了安装程序，确认是从官网下载的，可以点击"仍要运行"。

2.2 安装向导的每一步选项解析

Git的安装向导是全英文的，很多新手看不懂就直接一路Next，这样装出来的Git虽然能用，但后续可能出现各种不顺。我建议把每一步都过一遍，这里截取几个关键步骤重点说。

第一步是许可协议，直接Next。第二步是选择安装路径，默认在C:\Program Files\Git，这个路径没问题，不要改成带中文或者带空格的目录。下一步是选择组件，默认已经勾选了Git Bash Here、Git GUI Here等选项，建议保持全选，特别是"Add a Git Bash Profile to Windows Terminal"这个选项，如果你用Windows Terminal，勾上会更方便。

接下来是"Choosing the default editor used by Git"，这一步不少人会忽略。默认是Vim，但Vim对新手太不友好，随便按错一个键就卡在退出界面。建议在下拉列表里选择"Use Visual Studio Code as Git's default editor"，前提是你电脑上装了VS Code。如果你常用的编辑器是Notepad++或者Sublime，也可以选对应的。要是都没装，那还是先用Vim，不过我建议你顺手装个VS Code，后面看代码、改配置都用得上。

然后是"Adjusting your PATH environment"这一步，这个非常关键。默认选项是"Git from the command line and also from 3rd-party software"，意思是把Git添加到系统PATH中，这样你可以在cmd、PowerShell和第三方软件里直接使用git命令。还有两个选项分别是"Use Git Bash only"和"Use Git and optional Unix tools from the Command Prompt"，前者只允许在Git Bash里用Git，后者会把Git自带的Unix工具也暴露到系统PATH里，容易和Windows自带的命令冲突，比如find、sort这些。所以我强烈建议选择默认的中间选项，这是最干净又实用的配置。

后面还有一个"Choosing HTTPS transport backend"步骤，默认是"Use the OpenSSL library"，直接默认即可，因为现在GitHub、GitLab都支持OpenSSL证书。接着是行尾转换配置"Configuring the line ending conversions"，默认是"Checkout Windows-style, commit Unix-style line endings"。这个默认配置对于绝大多数纯Windows环境是合理的，因为你在Windows上编辑文件用CRLF，提交到Git仓库时Git会自动转成LF，团队协作也统一。如果你是在Windows上开发跨平台项目，服务端或团队成员都用Linux，也可以选择"Checkout as-is, commit Unix-style line endings"，保留本地原样。但建议新手直接默认，遇到问题再调整。

之后是终端模拟器选择，默认"Use MinTTY"，这个终端比Windows自带命令行更友好，字体和复制粘贴都更好用，保持默认。再下一步是"git pull"默认行为，推荐选择默认的"Default (fast-forward or merge)"，这也是Git官方推荐。凭据管理器就选"Git Credential Manager"，这是微软和GitHub合作推出的一款工具，可以在Windows上安全地存储HTTPS密码或令牌，避免每次推送都输密码。最后还有一堆"Enable file system caching"、"Enable symbolic link support"之类的实验选项，默认不勾，保持默认即可。

2.3 安装后的快速验证

安装完成后，桌面上可能不会自动生成快捷方式，但在资源管理器的右键菜单里会出现"Git Bash Here"和"Git GUI Here"两个选项，这就说明右键菜单集成成功了。打开开始菜单，找到"Git"文件夹，点击"Git Bash"，弹出一个类似Linux终端的窗口。

在Git Bash里输入命令验证是否安装成功：

git --version

如果看到类似git version 2.47.1.windows.1的输出，说明Git本体已经装好了。再输入：

which git

如果返回/usr/bin/git，说明当前调用的就是Git Bash内置的Git。为了验证系统PATH里的git是否也被正确指向，可以打开Windows的cmd或PowerShell，输入git --version，如果能正常显示版本号，就说明前面PATH环境变量配置成功。如果cmd里提示"git不是内部或外部命令"，那就要手动配置PATH，这部分我在下一节详细讲。

3. 环境变量与Git基础配置

3.1 PATH环境变量的原理与自定义配置

在Windows里，当你输入git命令，系统会在当前目录和PATH环境变量指定的所有目录里查找git.exe。如果安装时没选好PATH选项，或者你手动移除了，就会出现"git不是内部或外部命令"的报错。

定位到你的Git安装目录，默认是C:\Program Files\Git，其中可执行文件在C:\Program Files\Git\cmd。手动添加PATH的步骤是：右键"此电脑" → "属性" → "高级系统设置" → "环境变量"。在下方的"系统变量"列表里找到"Path"，双击打开，点击"新建"，把C:\Program Files\Git\cmd添加进去。确定后重新打开终端，再输入git --version验证。

这里有一个细节，新版Git在安装时会把cmd目录和bin目录都写入PATH，但bin目录包含了更多Unix工具，如果有多个版本的Git或与其他工具冲突，反而容易混乱。所以我推荐只把cmd目录加入PATH，这样你在cmd和PowerShell里能用的只是Git本身，不会干扰系统其他命令。

右键菜单里的"Git Bash Here"是直接在资源管理器里打开Git Bash，并定位到当前目录。如果你发现右键菜单里没有这个选项，可以重新运行安装包，选择"Modify"修改安装，把对应组件勾上。

3.2 全局身份配置

Git的每次提交都会记录提交者的姓名和邮箱，这是版本管理的基础信息。打开Git Bash，输入以下两行命令：

git config --global user.name "Your Name" git config --global user.email "youremail@example.com"

--global参数表示全局配置，对所有仓库生效。如果你只想给某个特定仓库设置不同的身份，可以去掉--global，在仓库目录下单独设置。这里一定要用你在代码托管平台注册的邮箱，尤其是GitHub，它会把提交记录和账号关联起来。

配置完成后，可以查看当前所有配置：

git config --list

如果想查看某一条配置，可以：

git config user.name git config user.email

这些配置最终会写入用户主目录下的~/.gitconfig文件。Git Bash里输入cd ~，再输入cat .gitconfig就能看到。如果后续要修改或删除某条配置，直接用文本编辑器改这个文件，或者使用git config --global --unset user.name这类命令。

3.3 常用基础配置与优化

除了身份信息，还有几个配置能明显改善使用体验。

一是配置默认分支名。新版本的Git默认分支名已经从master改成了main，但如果你用的版本旧，或者想自定义，可以设置：

git config --global init.defaultBranch main

这样以后执行git init新建仓库时，默认分支就是main。

二是设置换行符自动转换。Windows下如果之前安装时选择了默认项，那么core.autocrlf默认是true。如果要查看：

git config --global core.autocrlf

输出为true的话，Windows下使用默认即可。如果你是一个纯Windows单人项目，文件都在Windows上，也可以把autocrlf设为false，减少不必要的转换。但如果你参与跨平台协作，建议保持默认true。

三是设置别名。新手可以先不用，但如果你经常输错命令，可以用别名减少记忆负担：

git config --global alias.st status git config --global alias.co checkout git config --global alias.br branch git config --global alias.cm commit

设置之后，git st就等价于git status。这个很香，但要注意别把一个名字映射成两个命令。

四是开启缓存凭据。HTTPS认证时，Git Credential Manager已经在安装时默认启用，如果你还是被反复要求输密码，可以检查：

git config --global credential.helper manager

五是处理中文文件名乱码。Windows下Git默认会把中文文件名转义成八进制编码，显示成\345\233\276\347\211\207.png这种。建议执行：

git config --global core.quotepath false

这样中文文件名就能正常显示了。

4. SSH密钥的生成与配置

4.1 SSH密钥的工作原理

前面用HTTPS方式克隆代码时，每次推送都要输入账号密码或令牌，虽然Git Credential Manager能记住，但要频繁处理令牌过期的问题。更推荐的做法是配置SSH密钥，用公钥和私钥配对来验证身份。

你可以把SSH密钥理解成一把特殊门锁。公钥是锁，可以公开放在服务器或代码托管平台上；私钥是钥匙，只保存在你自己电脑的本地。当你向远程仓库推送时，服务器用公钥验证你的请求是否由对应私钥签名。因为私钥不出本机，公钥可以随便分发，所以安全性很高。

在Windows上，Git Bash自带ssh-keygen工具，所以不需要额外安装软件。我强烈建议使用SSH方式，特别是经常在命令行操作的朋友，省去每次输入凭证的麻烦。

4.2 在Git Bash中生成并测试密钥

打开Git Bash，输入以下命令：

ssh-keygen -t ed25519 -C "youremail@example.com"

-t指定加密算法，这里用的是ed25519。-C是注释，一般填你的邮箱，方便在平台上识别这个密钥属于谁。ed25519是目前推荐的非对称加密算法，密钥较短，安全性高，生成速度快。如果你的Git版本比较老，或者你对接的服务器不支持ed25519，可以使用RSA算法：

ssh-keygen -t rsa -b 4096 -C "youremail@example.com"

执行后会提示你确认保存路径，默认是/c/Users/你的用户名/.ssh/id_ed25519，直接回车即可。接着提示设置passphrase，也就是私钥密码。这里要注意，passphrase和SSH密钥本身是两回事，它是用来进一步保护私钥文件的。如果设置了passphrase，每次使用密钥时都会要求输入。简洁起见，新手可以直接回车跳过，但安全性会降低。我个人的建议是设置一个不太复杂的passphrase，然后配合ssh-agent每次开机只在首次使用时输入一次，这样兼顾安全和方便。

生成完成后，在~/.ssh目录下会多出两个文件：id_ed25519是私钥，id_ed25519.pub是公钥。可以先执行：

eval "$(ssh-agent -s)"

启动ssh-agent进程，然后把私钥添加到agent中：

ssh-add ~/.ssh/id_ed25519

如果设置过passphrase，这一步会要求输入。添加成功后，后面再使用SSH时，agent会自动完成私钥认证，不需要重复输入passphrase。

查看公钥内容：

cat ~/.ssh/id_ed25519.pub

输出是一串以ssh-ed25519开头的字符，这个字符串就是你需要在代码托管平台添加的公钥。

4.3 将公钥添加至代码托管平台

不同代码托管平台的操作大同小异。以GitHub为例，登录GitHub网站，点击右上角头像，选择"Settings"，在左侧菜单找到"SSH and GPG keys"，点击"New SSH key"。在"Title"里随便填一个名字，比如"Windows Work Laptop"，然后在"Key"框中粘贴刚才cat出来的公钥字符串，注意不要漏掉末尾的空格和邮箱部分，所以最好的办法是全选复制。最后点击"Add SSH key"。

Gitee（码云）和GitLab的流程类似，都是在个人设置里找到SSH公钥相关选项，粘贴保存。部分企业自建的GitLab还可能要求在SSH密钥设置里选择密钥有效期，按公司要求填写即可。

添加成功后，平台通常会根据公钥指纹生成一个指纹字符串，比如SHA256:xxxxxx，这个指纹以后可以在本地通过ssh-keygen -lf ~/.ssh/id_ed25519.pub来对比，确认你的公钥没有传错。

4.4 测试SSH连接与常见坑

配置好公钥后，在Git Bash里测试是否连通。以GitHub为例：

ssh -T git@github.com

第一次连接时，终端会提示确认远程主机的指纹，输入yes回车。如果成功，会看到类似Hi username! You've successfully authenticated, but GitHub does not provide shell access.的消息。这个信息不等于报错，它只是说明认证成功且对方不允许shell登录而已。

连接不上时，最常见的错误是Permission denied (publickey)。这个报错的意思是远程服务器拒绝了你携带的公钥。排查顺序是：

1. 确认公钥是否已经正确添加到了平台。
2. 确认你正在使用的私钥文件是否匹配。
3. 确认ssh-agent里是否加载了正确的私钥，执行ssh-add -l查看列表。
4. 确认当前目录是否有多把密钥，而Git Bash默认只读取~/.ssh/id_ed25519或~/.ssh/id_rsa，如果你的私钥文件名特殊，需要额外配置。

多账号场景下，比如你在GitHub有多个账号，或者同时用GitHub和GitLab，可以在~/.ssh目录下创建一个名为config的配置文件，内容参考：

Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519_work Host gitlab.com HostName gitlab.com User git IdentityFile ~/.ssh/id_ed25519_personal

这样Git会根据连接的Host自动选择对应的私钥文件，不会混用。

5. 实际使用中的问题排查与避坑体验

5.1 典型问题速查表

我在实际配置过程中，遇到过不少用户反馈同类问题。整理成一个速查表，方便大家对照排查。

这些是最常见的坑，如果你遇到了其他问题，建议先用git config --list和git remote -v两个命令看基础配置，大部分问题都能从这两条里找到线索。

5.2 我的几个实操心得

踩过几次坑之后，我现在给同事配置Git环境时，都会按下面这几点操作，基本一次过。

第一，不要用Windows自带的记事本编辑.gitconfig、.bashrc这些文件。记事本会把文件保存成带BOM的UTF-8格式，而Git和Git Bash对BOM支持不友好，可能导致配置解析出错。建议用VS Code或者Notepad++，如果只有记事本，保存时把编码选成UTF-8（不带BOM）。

第二，安装路径、仓库路径尽量都放在英文目录下。虽然Git官方已经实现了对Unicode路径的部分支持，但你无法保证所有第三方工具都兼容。最简单的做法就是新建一个C:\work\projects之类的目录，所有代码都放在这里，减少各种编码和权限问题。

第三，如果公司电脑有严格的安全策略，建议把Git安装包和密钥文件都放在用户目录下，并给.ssh文件夹设置好访问权限，防止其他账号读取私钥。在Windows上可以右键.ssh文件夹，进入"安全"选项卡，移除其他用户对该目录的读取权限。

第四，SSH passphrase不是摆设。我见过有人图省事不设置，后来电脑丢失或私钥泄露，账号直接被刷。建议设置一个中等强度的passphrase，配合ssh-agent使用并不会影响日常体验。设置后私钥即使被复制走，没有passphrase也不能直接使用。

第五，养成定期更新Git的习惯。Git for Windows每个版本都会修复安全漏洞和一些兼容性问题。可以在Git Bash里执行git update-git-for-windows来检查并更新，或者去官网下载新版覆盖安装。覆盖安装不会影响已有配置，非常省事。

最后再分享一个小技巧：如果你只是想在Windows下快速查看一次提交记录，不需要完整Git环境，推荐用VS Code自带的源代码管理面板，它把常见的add、commit、push、pull都封装成了图形界面，配合前面配置好的环境，舒适度直接提升一个档次。但真正出问题的时候，还是命令行的报错信息最准确，所以这两种方式我都建议掌握。希望这篇教程能帮你少走一些弯路。