VSCode远程连接服务器 同步代码到GitHub

在VS Code远程连接服务器的场景下，同步代码到GitHub的核心是：在服务器端配置Git和GitHub认证，然后通过VS Code的图形化界面或终端执行Git操作。以下是详细步骤：

一、准备工作

1. VS Code已安装必要插件
   本地VS Code需安装：
   • Remote - SSH（用于远程连接服务器）
   • Git（基础Git支持，通常默认安装）

确保服务器已安装Git
远程服务器上执行以下命令，若有版本输出则已安装，否则需安装：

git --version # 未安装的话（Ubuntu/Debian）：sudoapt-get update &&sudoapt-getinstall -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）：

1. 生成PAT：
   GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token：
   • 勾选权限：repo（仓库读写权限） → 生成后立即复制令牌（只显示一次）。

服务器端Git配置记住令牌（避免每次输入）：

git config --global credential.helper store # 永久保存凭据（服务器本地）

三、在VS Code中同步代码（两种场景）

场景1：服务器上已有代码，需关联到新的GitHub仓库

1. 在GitHub创建新仓库
   登录GitHub → New repository → 填写仓库名（如 flasc-project），不勾选“Initialize this repository with a README” → 创建仓库。
   • 若用HTTPS，会提示输入用户名（GitHub用户名）和密码（之前生成的PAT）。

服务器端代码关联GitHub仓库
在VS Code远程终端（进入代码目录，如 /root/AAcode/flasc-main）：

cd /root/AAcode/flasc-main # 进入你的代码目录git init # 初始化本地仓库gitadd.# 暂存所有文件git commit -m "首次提交代码"# 提交到本地仓库# 关联GitHub远程仓库（替换为你的仓库SSH/HTTPS地址）git remote add origin [email protected]:你的GitHub用户名/你的仓库名.git # SSH地址# 或 HTTPS地址：git remote add origin https://github.com/你的GitHub用户名/你的仓库名.gitgit push -u origin main # 推送到GitHub（首次推送加 -u，后续直接 git push）

场景2：服务器上克隆已有GitHub仓库（从零开始）

1. 在VS Code中打开仓库
   点击VS Code左侧“资源管理器” → “打开文件夹” → 选择克隆的仓库目录 → 打开。

在VS Code远程终端克隆仓库

# 克隆仓库（SSH地址，需已配置SSH密钥）git clone [email protected]:你的GitHub用户名/你的仓库名.git # 或 HTTPS地址：git clone https://github.com/你的GitHub用户名/你的仓库名.gitcd 仓库名 # 进入克隆的目录

四、日常同步操作（VS Code图形化界面）

1. 修改代码后提交到本地仓库
   • 左侧点击“源代码管理”图标（类似分支的图标） → 查看修改的文件。
   • 勾选要提交的文件（或点击“+”全部暂存） → 在“消息”框输入提交说明（如“修复xxx bug”） → 点击“√”提交。
2. 推送到GitHub
   提交后，点击源代码管理面板顶部的“↑”（推送）按钮，代码会同步到GitHub远程仓库。
3. 拉取GitHub最新代码（多人协作时）
   点击“↓”（拉取）按钮，获取远程仓库的最新更新，避免冲突。

五、常见问题解决

1. 推送失败提示“权限不足”
   • 检查SSH密钥是否正确添加到GitHub（方案1步骤2），或HTTPS令牌是否有效。
   • 确认远程仓库地址正确：git remote -v 查看，错误则修改：git remote set-url origin 新地址。
2. VS Code不显示Git状态
   • 确保已在VS Code中打开仓库目录（而非父目录）。
   • 按 Ctrl+Shift+P → 输入 Git: Initialize Repository 重新初始化。

提交时中文乱码
服务器端配置Git编码：

git config --global i18n.commitencoding utf-8 git config --global i18n.logoutputencoding utf-8 

通过以上步骤，即可在VS Code远程连接的服务器上无缝同步代码到GitHub，日常操作主要依赖VS Code的图形化界面，简单高效。