在 VS Code 远程连接服务器的场景下,同步代码到 GitHub 的核心是:在服务器端配置 Git 和 GitHub 认证,然后通过 VS Code 的图形化界面或终端执行 Git 操作。以下是详细步骤:
一、准备工作
- VS Code 已安装必要插件
本地 VS Code 需安装:Remote - SSH(用于远程连接服务器)Git(基础 Git 支持,通常默认安装)
确保服务器已安装 Git
远程服务器上执行以下命令,若有版本输出则已安装,否则需安装:
git --version # 未安装的话(Ubuntu/Debian):sudo apt-get update && sudo apt-get install -y git
二、服务器端配置 GitHub 认证(关键)
服务器需要有权限访问你的 GitHub 仓库(读/写),推荐用SSH 密钥(免密码,更方便),或HTTPS 令牌(需输入令牌验证)。
方案 1:SSH 密钥认证(推荐,一次配置永久生效)
1. 服务器端生成 SSH 密钥
在远程服务器的终端(VS Code 远程终端)执行:
ssh-keygen -t ed25519 -C "你的 GitHub 邮箱" # 按回车 3 次(无需设置密码)
生成的密钥在 ~/.ssh/ 目录下:私钥 id_ed25519,公钥 id_ed25519.pub。
2. 复制公钥到 GitHub
- 登录 GitHub → 右上角头像 →
Settings→ 左侧SSH and GPG keys→New SSH key:Title填服务器标识(如'我的远程服务器')Key粘贴刚才复制的公钥字符串 → 点击Add SSH key。
服务器端查看公钥内容:
cat ~/.ssh/id_ed25519.pub
复制输出的完整字符串(以 ssh-ed25519 开头,以你的邮箱结尾)。
3. 验证 SSH 连接
服务器端执行,测试是否能连接 GitHub:
ssh -T [email protected]
首次连接输入 yes,成功会显示 Hi 你的 GitHub 用户名!You've successfully authenticated...。
方案 2:HTTPS 令牌认证(适合临时使用)
若不方便配置 SSH,可使用 GitHub 个人访问令牌(PAT):
- 生成 PAT:
GitHub →Settings→Developer settings→Personal access tokens→Tokens (classic)→Generate new token:

