在 Windows 系统中永久配置 Git 使用 SSH 连接 GitHub 的三种方法：修改全局配置、创建 SSH 配置文件及使用 OpenSSH 服务。包含验证步骤、常用克隆命令、批量脚本工具以及多账户和性能优化的高级配置指南，帮助用户实现安全的代码托管连接。
# 1. 设置 Git 全局使用 SSH 代替 HTTPS
git config --global url."[email protected]:".insteadOf "https://github.com/"
# 2. 设置 SSH 命令使用您的密钥
git config --global core.sshCommand "ssh -i %USERPROFILE%\.ssh\id_ed25519"
# 3. 验证配置
git config --global --list | findstr "insteadof|sshCommand"
优点：配置简单，一键完成 缺点：所有仓库使用同一密钥
C:\Users\你的用户名\.ssh\config# GitHub Host
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
PreferredAuthentications publickey
# 可选：为不同 GitHub 账户配置不同密钥
Host github-work
HostName github.com
User git
IdentityFile ~/.ssh/work_key
chmod 600 ~/.ssh/config
优点：灵活，支持多账户，符合 SSH 标准
按 Win+X 选择管理员 PowerShell。
# 以管理员身份运行 PowerShell
# 1. 启用 SSH-Agent 服务
Set-Service ssh-agent -StartupType Automatic
# 2. 启动服务
Start-Service ssh-agent
# 3. 添加密钥到代理
ssh-add $HOME\.ssh\id_ed25519
# 4. 检查已加载的密钥
ssh-add -l
优点：系统级服务，重启后自动加载密钥
# 测试 SSH 连接
ssh -T [email protected]
预期输出：
Hi 用户名! You've successfully authenticated, but GitHub does not provide shell access.
创建诊断脚本 check_ssh.bat：
@echo off
echo ===== SSH 配置诊断工具 =====
echo.
echo [1] 检查密钥文件...
if exist "%USERPROFILE%\.ssh\id_ed25519" (
echo ✓ 找到私钥文件
) else (
echo ✗ 未找到私钥文件，请先生成 SSH 密钥
)
echo.
echo [2] 检查 SSH 配置文件...
if exist "%USERPROFILE%\.ssh\config" (
type "%USERPROFILE%\.ssh\config"
echo.
) else (
echo ℹ 未找到 config 文件，将使用默认配置
)
echo
[3] 测试 GitHub 连接...
ssh -T [email protected] 2>&1 | findstr "successfully" >nul
if %errorlevel%==0 (
echo ✓ SSH 连接测试成功
) else (
echo ✗ SSH 连接测试失败
echo 请检查：1.公钥是否添加到 GitHub 2.网络连接
)
echo.
echo [4] 测试 Git 操作...
echo 正在克隆测试仓库...
git clone [email protected]:github/gitignore.git ssh-test-temp --depth=1 2>nul
if exist "ssh-test-temp" (
echo ✓ Git 克隆测试成功
rmdir /s /q ssh-test-temp 2>nul
) else (
echo ✗ Git 克隆测试失败
)
echo.
echo ===== 诊断完成 =====
pause
# 基本格式
git clone [email protected]:用户名/仓库名.git
# 带分支和重命名
git clone -b 分支名 [email protected]:用户名/仓库名.git 自定义目录名
# 示例
git clone [email protected]:microsoft/vscode.git
git clone -b main [email protected]:facebook/react.git react-project
# 1. 克隆包含子模块的仓库
git clone --recursive [email protected]:用户名/仓库名.git
# 2. 浅克隆（只获取最新提交，加快速度）
git clone --depth=1 [email protected]:用户名/仓库名.git
# 3. 克隆特定标签版本
git clone -b v1.0.0 [email protected]:用户名/仓库名.git
# 4. 限制克隆深度和过滤文件
git clone --filter=blob:none [email protected]:用户名/大仓库名.git
# 进入仓库目录
cd 仓库目录
# 查看当前远程地址
git remote -v
# 修改为 SSH 地址（假设原地址是 HTTPS）
git remote set-url origin [email protected]:用户名/仓库名.git
# 验证修改
git remote -v
gclone.bat@echo off
echo GitHub SSH 克隆工具
echo ====================
if "%1"=="" goto usage
set "repo=%1"
set "branch=%2"
set "target=%3"
:: 处理输入格式
echo %repo% | findstr "^git@" >nul
if errorlevel 1 (
echo %repo% | findstr "^https://" >nul
if errorlevel 1 (
:: 用户输入的是 用户名/仓库名 格式
set "[email protected]:%repo%.git"
) else (
:: 将 HTTPS 地址转换为 SSH 地址
set "repo=%repo:https://github.com/[email protected]:%"
set "repo=%repo:/=.git%"
)
)
:: 构建命令
set "cmd=git clone %repo%"
if not "%branch%"=="" set "cmd=%cmd% -b %branch%"
if not "%target%"=="" set "cmd=%cmd% %target%"
echo.
echo 执行命令：%cmd%
echo.
%cmd%
if %errorlevel%==0 (
echo ✓ 克隆成功！
) else (
echo ✗ 克隆失败，请检查网络或仓库地址
)
goto :eof
:usage
echo 使用方法：
echo gclone 用户名/仓库名 [分支] [目标目录]
echo gclone HTTPS 地址 [分支] [目标目录]
echo gclone SSH 地址 [分支] [目标目录]
echo.
echo 示例：
echo gclone microsoft/vscode
echo gclone https://github.com/facebook/react.git main react-app
echo gclone [email protected]:vuejs/vue.git
pause
clone-multi.bat@echo off
echo 批量克隆工具
echo =============
setlocal enabledelayedexpansion
:: 定义要克隆的仓库列表
set "repos[0]=microsoft/vscode"
set "repos[1]=facebook/react"
set "repos[2]=vuejs/vue"
set "repos[3]=tensorflow/tensorflow"
set "repos[4]=pytorch/pytorch"
echo 可用仓库：
for /l %%i in (0,1,4) do (
echo [%%i] !repos[%%i]!
)
echo.
echo 选择模式：
echo 1. 克隆单个仓库
echo 2. 克隆所有仓库
echo 3. 自定义仓库列表
set /p mode="请选择 (1/2/3): "
if "%mode%"=="1" (
set /p index="输入仓库编号 (0-4): "
for /l %%i in (0,1,4) do (
if "!index!"=="%%i" (
echo 正在克隆：!repos[%%i]!
git clone [email protected]:!repos[%%i]!.git
)
)
) else if "%mode%"=="2" (
echo 开始克隆所有仓库...
for /l %%i in (0,1,4) do (
echo.
echo [!repos[%%i]!] git clone [email protected]:!repos[%%i]!.git
)
echo.
echo 所有仓库克隆完成！
) else if "%mode%"=="3" (
echo 每行输入一个仓库（格式：用户名/仓库名），空行结束：
set i=0
:input_loop
set /p repo="> "
if not "!repo!"=="" (
set "custom[!i!]=!repo!"
set /a i+=1
goto input_loop
)
echo.
echo 开始克隆自定义仓库...
for /l %%j in (0,1,!i!) do (
echo [!custom[%%j]!] [email protected]:!custom[%%j]!.git
echo.
)
)
pause
# ~/.ssh/config 文件内容
# 个人账户（默认）
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_personal
IdentitiesOnly yes
# 工作账户
Host github-work
HostName github.com
User git
IdentityFile ~/.ssh/id_rsa_work
IdentitiesOnly yes
# 其他 Git 托管服务
Host gitlab.com
HostName gitlab.com
User git
IdentityFile ~/.ssh/id_ed25519_gitlab
使用不同账户克隆：
# 使用个人账户（默认）
git clone [email protected]:个人用户名/仓库.git
# 使用工作账户
git clone git@github-work:公司用户名/仓库.git
# 提高大文件传输性能
git config --global http.postBuffer 524288000
# 启用文件系统缓存（加速状态检查）
git config --global core.fscache true
# 设置并发线程数（提高克隆速度）
git config --global core.packedGitLimit 512m
git config --global core.packedGitWindowSize 512m
# 启用压缩（节省带宽）
git config --global core.compression 9
# 设置 SSH 连接超时
git config --global core.sshCommand "ssh -o ConnectTimeout=30 -i %USERPROFILE%\.ssh\id_ed25519"
在 Windows Terminal 的 settings.json 中添加：
{
"profiles": {
"defaults": {
"environment": {
"GIT_SSH_COMMAND": "ssh -i %USERPROFILE%\\.ssh\\id_ed25519"
}
}
}
}
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online