第九节 【Git远程仓库篇】本地VS Code通过SSH免密连接Gitee远程仓库（详细完整教程）

【Git远程仓库篇】本地VS Code通过SSH免密连接Gitee远程仓库（详细完整教程）

• 前言
• 一、 相关介绍
• • 1.1 VS Code介绍
  • 1.2 Gitee介绍
• 二、实践环境规划
• • 2.1 环境准备
  • 2.2 SSH免密原理
• 三、生成 SSH 密钥对
• • 3.1 执行生成命令
  • 3.2 三次回车的含义
  • 3.3 确认结果
  • 3.4 复制公钥
• 四、把公钥添加到 Gitee
• 五、验证连接是否成功
• 六、让 VS Code 正确使用这把密钥
• • 6.1 情况一：密钥在默认路径（最常见，无需额外配置）
  • 6.2 情况二：自定义了文件名 / 有多个账号 → 配置 `~/.ssh/config`
  • 6.3 情况三：只想让 Git 走指定密钥（不改 config）
  • 6.4 确保 ssh-agent 在运行（设了 passphrase 或重启后失效必看）
• 七、在 VS Code 里克隆 / 关联 / 推送代码
• • 7.1 配置Git身份信息
  • 7.2 方式 A：克隆已有仓库（推荐新手）
  • 7.3 方式 B：本地已有项目，首次推送到 Gitee
  • 7.4 方式 C：已有 HTTPS 远程地址，改成 SSH（不用重新克隆）
  • 7.5 图形化操作（日常最常用）
• 八、上传项目
• • 8.1 新增文件
  • 8.2 源代码管理推送方式
  • 8.3 终端推送方式
• 九、注意事项
• • 9.1 VS Code 专属的两个设置
  • 9.2 常见问题排查速查表
  • 9.3 安全建议（配通之后请务必看）
• 十、总结
• 附录：命令速查清单

前言

在日常开发中，我们经常需要将本地代码与远程仓库进行同步，而每次推送或拉取代码时反复输入用户名和密码不仅繁琐，还会降低工作效率。SSH 免密连接正是解决这一痛点的最佳方案，它通过非对称密钥实现安全、便捷的身份认证，让 Git 操作一气呵成。本文将手把手带您完成从生成密钥、配置 Gitee 到在 VS Code 中实现免密推送的完整流程，全程图文并茂、步骤清晰。无论您是刚接触 Git 的新手，还是想优化工作流的老手，都能在这篇教程中找到适合自己的配置方案。

一、 相关介绍

1.1 VS Code介绍

Visual Studio Code（简称 VS Code）是微软推出的一款免费、开源、跨平台代码编辑器，支持 Windows、macOS 和 Linux 系统。 它既不像传统文本编辑器那样功能简单，也不像重型 IDE 那样臃肿，而是以轻量高效为核心，内置了 IntelliSense 智能代码补全、语法高亮、实时错误检测、集成终端、内置调试器和 Git 版本控制等能力。 通过扩展市场，开发者可以按需安装语言支持、代码格式化、远程开发、Docker、AI 编程助手等插件，把它定制成适配不同开发场景的工具。 目前 VS Code 已深度集成 AI 智能体能力，支持用自然语言描述任务并自动规划、编辑和验证代码，广泛应用于 Web 前端、后端、运维、云计算、数据科学等多种开发场景。

• Visual Studio Code下载页：https://visuals