在windows上安装git并配置ssh密钥是连接github等平台推送代码的前提:下载安装git客户端,配置全局用户信息,生成ed25519密钥对,添加至ssh-agent,将公钥粘贴到平台ssh设置中,最后用ssh -t验证连接。

在Windows系统上安装Git客户端并配置SSH密钥,是连接GitHub、GitLab或自建Git服务器的必备前提,没有这一步就无法安全推送代码或克隆私有仓库。
下载并安装Git客户端
访问官方唯一可信渠道 https://git-scm.com/download/win,点击页面上的“Click here to download”按钮,获取最新版64位安装包(如Git-2.51.2-64-bit.exe);若网络受限,可改用阿里云镜像站搜索“Git Windows”下载对应版本。
双击运行安装程序,用户账户控制提示时点【是】。
许可协议页直接点【Next】;安装路径建议保持默认(C:\Program Files\Git),避免后续开发工具(如VS Code、PyCharm)找不到Git导致反复手动配置路径。
组件选择页务必勾选:Git Bash Here、Git GUI Here、Associate .sh files;其他默认选项保留即可。
环境变量配置页必须选择第二项:“Git from the command line and also from 3rd-party software”,否则PowerShell或IDE中执行git命令会报“不是内部或外部命令”。
后续所有选项保持默认:Use bundled OpenSSH → Use the OpenSSL library → Checkout Windows-style, commit Unix-style line endings → Use MinTTY → Default (fast-forward or merge) → Git Credential Manager Core → Enable file system caching,全部点【Next】直至【Install】。
初始化全局用户信息
安装完成后,右键桌面空白处,选择【Git Bash Here】,输入以下两条命令(替换为你的真实姓名和常用邮箱):
git config --global user.name "张三"
git config --global user.email "zhangsan@example.com"
这两条配置决定了每次commit的作者身份,必须执行且不可为空,否则后续提交会被标记为unknown。
生成并配置SSH密钥对
在Git Bash中执行:
ssh-keygen -t ed25519 -C "zhangsan@example.com"
连续按三次回车:不设置密码短语(适合日常开发)、密钥保存到默认路径~/.ssh/id_ed25519;不要手动修改文件名或路径,否则后续步骤容易出错。
启动ssh-agent并加载密钥:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
复制公钥内容到剪贴板:
cat ~/.ssh/id_ed25519.pub | clip
打开GitHub/GitLab等平台的SSH Keys设置页(如GitHub:Settings → SSH and GPG keys → New SSH key),Title填“Work Laptop - Windows”,Key type选“Authentication Key”,粘贴刚刚复制的内容,点【Add SSH key】。
验证SSH连接是否生效
在Git Bash中执行:
ssh -T git@github.com
首次运行会提示是否继续连接,输入yes;若看到类似“Hi zhangsan! You've successfully authenticated...”的响应,说明SSH密钥已正确部署并被服务端认可。
若返回“Permission denied (publickey)”,请检查:是否漏掉ssh-add步骤、公钥是否完整粘贴(开头是ssh-ed25519,结尾含邮箱)、平台侧是否误粘了换行符或空格。











