VSCode 连接 GitHub / Gitee 远程仓库详细步骤(SSH + HTTPS)最全教程

[复制链接]
发表于 2026-10-3 22:07:56 | 显示全部楼层 |阅读模式

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有账号?立即注册

×

本地代码怕误删、怕丢,最稳妥的办法就是推到远程仓库。GitHub、Gitee 这类平台既能上传下载代码,也支持分支管理与合并,多人协作效率提升明显。本文把 VSCode 连接远程仓库的两种方式——SSH 与 HTTPS——从零到能推送完整走一遍。

一、准备工作

1. 安装 Git

VSCode 靠 Git 连接和管理远程仓库,所以先装 Git。到 Git 官网下载对应系统的安装包(本文以 Windows x64 为例),双击安装,一般保持默认选项即可(安装路径可自行修改)。装完在任意文件夹右键,出现「Git Bash Here」和「Git GUI Here」两项,就说明装成功了。

2. 配置用户名和邮箱

在文件夹里右键选 Git Bash Here(相当于在该目录开一个命令行终端),设置全局用户名和邮箱:

git config --global user.name "用户名"      # 设置全局 Git 用户名
git config --global user.email "邮箱地址"    # 设置全局 Git 用户邮箱

用户名可自定,邮箱填自己的。设完用 git config --list 查看是否生效。

3. 在 GitHub 创建新仓库

进入自己的 GitHub 主页,点创建新仓库,写上仓库名。希望别人能访问就选 public,不希望就选 private,然后创建。

二、通过 HTTPS 连接 GitHub

1. 在 VSCode 里选择远程源

在 VSCode 中找到远程源入口,没配置过的点一次 new repository。点击后右侧状态栏会出现相应选项,接着跳转到浏览器做 GitHub 账户登录验证——输账号密码即可,已登录过的话直接 chooser 选用户就行。选完就能看到刚创建的仓库,点选要关联的库、输入仓库名,关联就完成了。

2. 暂存、提交、推送

写完代码按 Ctrl + S 保存,左侧源代码管理器会出现变更提示。点 + 号把改动加入暂存区,在上方输入框写一句提交说明(commit、update 之类),点提交。

提交后代码还在 VSCode 的本地缓存区,点右上角三个点选推送,代码就上到远程仓库了。回 GitHub 仓库刷新看看,提交已在上方便完成。

三、通过 SSH 连接 GitHub

1. 生成公钥私钥

选一个文件夹右键 Git Bash Here,输入命令并连按三次回车,会生成 .ssh 文件夹(一般在用户根目录),里面包含 id_rsa 私钥和 id_rsa.pub 公钥两个文件:

ssh-keygen -t rsa -C "邮箱地址"

2. 设置 config 文件

进入 .ssh 文件夹,新建一个无后缀名的 config 文件,写入以下内容并保存:

Host github.com
  HostName ssh.github.com
  User git
  Port 443
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/id_rsa

这套配置的作用是把 GitHub 的 SSH 端口改成 443,在公司网络封锁 22 端口时尤其有用。

3. 配置免密登录

把 id_rsa.pub 公钥的全部内容复制,进入 GitHub 设置里的 SSH 选项,粘贴进 key 输入框,title 随便起个名字,点 Add SSH key 即生效。

4. 初始化远程仓库并推送

在 VSCode 工作区选中要纳入仓库的文件夹,右键打开终端,依次执行:

git init                                                        # 仓库初始化
git add README.md                                               # 添加文件
git commit -m "first commit"                                     # 提交
git branch -M main                                              # 建分支
git remote add origin [email protected]:用户名/仓库名.git            # 连接远程仓库
git push -u origin main                                         # 推送

第一次用命令行推完一次之后,VSCode 就会自动记住 SSH 连接,之后推送直接在界面上点按钮即可,操作方式和 HTTPS 完全一致。

小结

HTTPS 方式配置最简单,浏览器登录一次就能推,适合日常上手;SSH 方式一配好就永久免密,还不受 22 端口封锁影响,适合长期固定环境。两种方式在 VSCode 里的推送操作是一样的。选哪个取决于你是否经常换设备——经常换就 HTTPS,固定机器就 SSH 一劳永逸。

qidao123.com企服评测-应用市场 编辑提示

回复

使用道具 举报

登录后关闭弹窗

登录参与点评抽奖  加入IT实名职场社区
去登录
快速回复 返回顶部 返回列表