1. 为什么需要SSH密钥连接Gitee作为一个刚接触Git版本控制的新手开发者我第一次在VSCode中配置Git环境时最头疼的就是每次推送代码都要反复输入账号密码。后来发现用SSH密钥认证就像给自家大门装了指纹锁——既安全又省去了带钥匙的麻烦。SSH协议通过非对称加密技术建立安全连接公钥放在Gitee服务器私钥留在本地每次交互时系统会自动完成验证。实际开发中会遇到两种密钥使用场景一种是绑定个人账户的全局公钥可以操作名下所有仓库另一种是仅针对特定仓库的部署公钥通常用于服务器自动化部署。我刚开始分不清这两者的区别有次误把部署公钥当成账户公钥使用结果怎么都推送不了代码折腾了半天才发现权限不足。后来才明白就像小区门禁卡账户公钥能进出所有楼栋而快递柜取件码部署公钥只能打开特定柜门。2. 环境准备与SSH密钥生成2.1 Git安装与基础配置在开始前需要确保本地已安装Git。官网下载时有个细节要注意Windows用户记得勾选Git from the command line and also from 3rd-party software选项这样VSCode才能正确调用Git。安装完成后我习惯先在终端跑几个命令检查环境git --version ssh -V接下来配置用户信息这里有个新手容易踩的坑username应该填Gitee个人资料里的姓名而不是登录账号。我有次填错导致提交记录显示为乱码后来用以下命令修正git config --global user.name 你的Gitee姓名 git config --global user.email 你的注册邮箱2.2 生成SSH密钥对执行密钥生成命令时很多教程会建议用邮箱当注释ssh-keygen -t rsa -C your_emailexample.com但其实-C后面的内容只是标签用任何文字都可以。我测试过用项目名做标签完全不影响使用。连续按三次回车后会在~/.ssh目录生成两个文件id_rsa私钥相当于家门钥匙id_rsa.pub公钥相当于钥匙模具有个实用技巧如果担心默认密钥被覆盖可以用-f参数指定文件名。比如我为工作项目单独创建了密钥ssh-keygen -t rsa -f ~/.ssh/gitee_work_key3. 在Gitee配置公钥3.1 添加账户公钥用记事本打开公钥文件复制内容时注意别多出空格或换行。我遇到过因为复制格式不对导致添加失败的情况。Gitee添加路径是 个人设置 → 安全设置 → SSH公钥 → 添加公钥这里有个安全细节添加公钥时需要验证账户密码。建议把公钥标题写成办公电脑-2024这样的格式方便后期管理。我有次清理旧设备时靠这种命名方式快速定位到了需要删除的密钥。3.2 测试连接执行连接测试命令时首次会出现RSA密钥指纹确认ssh -T gitgitee.com看到successfully authenticated提示才算成功。如果报错可以加-v参数查看详细日志ssh -vT gitgitee.com我遇到过连接超时的情况后来发现是公司网络限制了SSH端口。这种情况可以改用HTTPS协议或者配置SSH over HTTPSvim ~/.ssh/config Host gitee.com Hostname ssh.gitee.com Port 4434. VSCode实战配置4.1 克隆仓库在VSCode中按CtrlShiftP调出命令面板输入git clone时要注意如果之前配置过GitHub等平台可能需要先清除凭据管理器里的旧记录。我有次克隆一直失败后来在Windows凭据管理器里删除了过期凭证才解决。选择保存路径时建议使用纯英文路径。我有个项目放在文档/测试项目目录下结果因为中文路径导致部分插件异常。4.2 提交与推送代码VSCode的Git面板用颜色和图标区分文件状态绿色U未跟踪的新文件黄色M已修改文件红色D已删除文件提交时有个实用技巧先暂存部分改动Stage Changes而不是全选提交。就像搬家时分箱打包把相关修改放在同个提交里。我习惯用快捷键CtrlEnter提交已暂存文件AltC打开提交消息输入框首次推送时可能会要求输入凭据这时应该选择SSH方式而不是HTTPS。如果遇到权限拒绝错误检查.git/config文件中的url格式应该是[remote origin] url gitgitee.com:username/repo.git5. 高级配置与问题排查5.1 多账号管理当需要同时使用Gitee和GitHub时可以通过config文件区分# ~/.ssh/config Host gitee HostName gitee.com IdentityFile ~/.ssh/gitee_key Host github HostName github.com IdentityFile ~/.ssh/github_key克隆时替换域名部分git clone gitgitee:username/repo.git5.2 常见错误解决如果出现Permission denied (publickey)错误按以下步骤排查检查ssh-agent是否运行eval $(ssh-agent -s)添加私钥ssh-add ~/.ssh/id_rsa验证密钥指纹ssh-keygen -lf ~/.ssh/id_rsa.pub我遇到过最棘手的问题是换电脑后所有操作都报错最后发现是因为旧系统生成的密钥格式较新需要转换ssh-keygen -p -f ~/.ssh/id_rsa -m PEM6. 效率提升技巧6.1 自动化脚本把常用操作写成shell脚本比如这个自动初始化新仓库的脚本#!/bin/bash repo_name$1 git init git remote add origin gitgitee.com:username/$repo_name.git touch README.md git add . git commit -m Initial commit git push -u origin master6.2 VSCode插件推荐GitLens查看代码修改历史Git Graph可视化分支关系Remote-SSH直接编辑远程服务器文件有个冷门但好用的功能在设置中开启Git: Terminal Authentication可以避免频繁输入密码{ git.terminalAuthentication: false }7. 最佳实践建议日常开发中我养成了这些习惯每次开工前先git pull更新代码功能开发使用独立分支提交信息按格式写类型(范围): 描述比如feat(auth): 添加短信登录敏感信息写在.gitignore里有次我不小心把.env文件提交了后来用git filter-branch才清理干净对于团队项目建议在Gitee仓库设置里开启分支保护防止直接推送master分支。代码审查时多用git diff --color-words查看细微改动比整行对比更清晰。