为什么需要Git公钥
在使用Git管理代码时，本地仓库和GitHub、Gitee或GitLab等远程仓库之间的通信需要身份验证。传统的用户名密码方式不仅每次都要输入，而且不够安全。SSH公钥机制通过一对加密密钥实现免密登录，本地保存私钥，远程服务器只认公钥，既方便又符合现代开发的安全规范。
检查是否已存在密钥
在开始之前，先看看电脑里是否已经有现成的Git密钥。打开终端或命令行工具，输入命令查看用户目录下的隐藏文件夹。如果看到名为ssh的文件夹以及里面的id_rsa和id_rsa.pub文件，说明已经生成过密钥，可以直接跳过生成步骤。建议重新生成一套全新的密钥以保证安全。
生成新的SSH公钥
接下来正式创建密钥对。在终端中运行标准生成命令，邮箱地址可以填写你平时注册代码平台的账号邮箱，系统会把它作为密钥备注。执行后按回车确认默认保存路径即可，不需要手动指定文件名。整个过程只需几秒钟，系统会显示一串随机字符作为指纹信息。
生成完成后，去刚才提示的目录里找到后缀为pub的文件，这就是你的公钥。用文本编辑器打开它，全选并复制全部内容。注意不要漏掉开头和结尾的字样，也不要随意换行，否则上传后会校验失败。
将公钥添加到远程平台
复制好公钥内容后，登录你的代码托管平台进入账户设置页面。找到安全与认证选项下的SSH密钥管理入口，点击添加新密钥按钮。把粘贴板里的内容完整填进去，标题栏随便写个设备名称方便日后识别，比如公司电脑或者个人笔记本。保存成功后平台通常会发一封邮件确认。
配置SSH代理与连接测试
为了让系统自动识别密钥，需要把私钥加入SSH代理进程。执行加载命令后，再次运行测试指令连接远程仓库。如果提示欢迎字样并且显示对应的用户名，说明公钥配对成功，后续拉取推送代码都将不再询问密码。若出现权限拒绝错误，请检查文件权限设置是否正确，确保私钥只有当前用户可读。
常见问题排查指南
很多新手在配置过程中会遇到各种报错。最常见的是权限问题，Linux和macOS系统下私钥文件必须设置为仅所有者可读写，可以通过修改属性命令快速修复。Windows用户如果发现终端无法识别ssh命令，通常需要安装完整的Git客户端或者配置环境变量。另外注意区分HTTPS和SSH协议的克隆链接，一旦切换了协议类型，之前的公钥配置就会失效，需要重新走一遍流程。
掌握这套流程后，日常开发中的版本控制操作会变得异常顺畅。定期更换密钥也是良好的安全习惯，尤其是离职交接或多设备共用时，及时清理旧密钥能有效防止未授权访问。按照上述步骤一步步操作，几分钟就能完成环境搭建，彻底告别重复输入密码的繁琐。
