Win11安装Git与SSH配置教程

本文手把手教你如何在Windows 11系统（如Surface Laptop 5）上完成Git的安装与SSH密钥的全流程配置——从官网下载安装、定制化选项设置，到生成安全的ed25519密钥对、将公钥精准添加至GitHub或Gitee账户，最后通过ssh -T命令一键验证连接成功，确保你零障碍接入远程代码仓库，轻松开启高效、安全的版本管理之旅。

如果您需要在Windows 11系统上进行代码版本管理，但尚未安装Git或配置好身份验证，可能会导致无法与远程仓库（如GitHub、Gitee）进行通信。以下是完成Git安装及SSH密钥配置的详细步骤：

本文运行环境：Surface Laptop 5，Windows 11。

一、下载并安装Git

安装Git是配置开发环境的第一步，它提供了命令行工具和基础库，使您能够在本地进行版本控制操作。

1、访问Git官方网站 https://git-scm.com，网站会自动识别您的操作系统并推荐下载链接，点击“Download for Windows”按钮下载安装包。

2、下载完成后，双击运行安装程序（文件名类似于 Git-2.xx.x-64-bit.exe），在欢迎界面点击“Next >”继续。

3、阅读并接受许可协议，然后点击“Next >”。

4、选择安装路径，建议使用默认路径，点击“Next >”。

5、在“Select Components”界面，确保勾选了“Git Bash Here”和“Git GUI Here”选项，以便在右键菜单中快速启动，然后点击“Next >”。

6、在“Adjusting your PATH environment”页面，选择 "Git from the command line and also from 3rd-party software" 选项，这将把Git添加到系统的PATH环境变量中，方便在任何命令行工具中使用。

7、在“Choosing the SSH executable”页面，选择 "Use bundled OpenSSH"，使用Git自带的SSH客户端，无需额外配置。

8、在“Configuring the line ending conversions”页面，选择 "Checkout Windows-style, commit Unix-style line endings"，以解决Windows和Linux系统间的换行符差异问题。

9、在“Configuring the terminal emulator to use with Git Bash”页面，选择 "Use MinTTY (the default terminal of MSYS2)"，获得更好的终端体验。

10、其余设置保持默认，一路点击“Next >”，最后点击“Install”开始安装。

11、安装完成后，取消勾选“View Release Notes”（可选），点击“Finish”。

二、生成SSH密钥对

SSH密钥用于在不输入密码的情况下安全地验证您的身份，向Git服务提供商证明您有权访问特定的仓库。

1、在桌面或任意文件夹空白处点击鼠标右键，选择“Git Bash Here”来启动Git Bash命令行工具。

2、在打开的终端窗口中，输入以下命令来生成新的SSH密钥对，请务必将邮箱地址替换为您在GitHub或Gitee等平台注册的邮箱：
ssh-keygen -t ed25519 -C "your_email@example.com"

3、当提示“Enter a file in which to save the key”时，直接按回车键，接受默认的保存路径（通常是 /c/Users/YourUsername/.ssh/id_ed25519）。

4、接下来会要求您输入一个密码（passphrase）。为了更高的安全性，建议设置一个强密码。如果不想每次使用都输入密码，可以留空直接按回车。

5、确认并再次输入密码（如果设置了的话）。成功后，终端会显示密钥的指纹和随机艺术图样，表示密钥已生成。

三、将公钥添加到Git托管平台

此步骤是将您本地生成的公钥上传到远程Git服务器（如GitHub、Gitee），建立信任关系，允许您的计算机通过SSH协议访问您的账户或仓库。

1、在Git Bash中，输入命令查看公钥内容：
cat ~/.ssh/id_ed25519.pub

2、复制从ssh-ed25519开头，一直到您的邮箱地址结束的整行文本。请确保完整复制，包括开头和结尾，不要遗漏任何字符。

3、登录到您的Git托管平台（例如 GitHub: https://github.com 或 Gitee: https://gitee.com）。

4、进入账户设置，通常在右上角头像下拉菜单中找到“Settings”或“个人设置”。

5、在设置侧边栏中，找到“SSH and GPG keys”（GitHub）或“安全设置”下的“SSH 公钥”（Gitee）。

6、点击“New SSH key”或“添加公钥”按钮。

7、在“Title”字段中输入一个描述性的名称，例如“My Windows 11 PC”，以便日后识别。

8、在“Key”或“公钥内容”字段中，粘贴您之前复制的公钥文本。

9、根据平台要求，可能需要输入账户密码进行验证，然后点击“Add SSH key”或“确定”按钮完成添加。

四、测试SSH连接

测试连接是验证您的SSH密钥是否已正确配置并被远程服务器接受的关键步骤，避免在后续拉取或推送代码时出现问题。

1、回到Git Bash命令行工具。

2、根据您使用的平台，执行相应的测试命令：
对于GitHub，输入：ssh -T git@github.com
对于Gitee，输入：ssh -T git@gitee.com

3、首次连接时，会看到一条安全警告，询问是否信任该主机。输入 yes 并按回车。

4、如果配置成功，您将收到一条欢迎消息，例如来自GitHub的“Hi username! You've successfully authenticated...”或来自Gitee的“Hi USERNAME! You've successfully authenticated...”，这表明您的SSH连接已建立。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Win11安装Git与SSH配置教程》文章吧，也可关注golang学习网公众号了解相关技术文章。