VSCode 远程开发环境完整搭建指南:汉化、SSH 免密连接与版本更新锁定

在进行 Linux 服务端开发、网页部署、漏洞靶场搭建时,频繁切换虚拟机窗口、用 vi 编辑代码效率很低。通过 VSCode 的 Remote - SSH 能力,可以直接在本地编辑器里操作远程服务器文件,保存即同步,配合内置终端直接执行命令,大幅提升开发效率。本文从零开始,完整讲解 VSCode 汉化、远程连接 CentOS、配置免密登录与禁用自动更新的全流程,打造一套稳定高效的远程开发环境。


准备工作

  1. 本地 Windows 电脑已安装 VSCode

  2. 一台可用的 CentOS 服务器(虚拟机 / 物理机均可,本文以 CentOS Stream 9 为例)

  3. 服务器已开启 SSH 服务,防火墙放行 22 端口

  4. 知晓服务器 IP 地址、root 账号及登录密码


一、VSCode 界面汉化(简体中文)

默认 VSCode 为英文界面,先安装官方语言包切换为中文,降低上手门槛。

  1. 打开 VSCode,点击左侧边栏的扩展图标 (四个方块样式),或直接按快捷键 Ctrl + Shift + X 打开扩展面板。

  2. 在顶部搜索框输入 Chinese (Simplified),找到微软官方出品的「Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code」。

  3. 点击「安装」,等待安装完成后,右下角会弹出重启提示,点击「重启 (Restart)」。

  4. VSCode 重启后,整个界面就会切换为简体中文。


二、安装 Remote - SSH 远程开发插件

Remote - SSH 是微软官方的远程开发插件,让 VSCode 可以通过 SSH 协议连接到远程服务器,把服务器当成本地一样编辑代码。

  1. 同样在扩展面板(Ctrl + Shift + X)中,搜索 Remote - SSH

  2. 找到微软官方发布的「Remote - SSH」插件,点击「安装」。

  3. 安装完成后,左侧边栏会出现一个远程资源管理器图标(显示器样式),代表插件安装成功。


三、配置 SSH 远程连接 CentOS 服务器

1. 添加远程主机

  1. 点击左侧「远程资源管理器」,顶部下拉选择「SSH」,点击右侧的 + 号(添加新主机)。

  2. 在弹出的输入框中,输入 SSH 连接命令,格式为:

    复制代码
    ssh root@服务器IP地址

    例如:

    复制代码
    ssh root@192.168.6.132

    输入完成按回车确认。

2. 选择配置文件

接下来会提示「选择要更新的 SSH 配置文件」,选择第一个

复制代码
C:\Users\你的用户名\.ssh\config

这是当前 Windows 用户的个人 SSH 配置文件,只对自己账号生效,管理和修改都很方便,个人使用推荐选这个。

确认后右下角提示「已添加主机」,代表主机信息已保存。

3. 连接远程服务器

  1. 在远程资源管理器的 SSH 列表中,找到刚添加的服务器 IP。

  2. 鼠标移到主机名上,点击右侧出现的「在新窗口中连接」图标(箭头向外)。

  3. 弹出平台选择窗口,CentOS 属于 Linux 系统,选择 Linux,按回车确认。

  4. 弹出主机密钥指纹验证提示,这是 SSH 的安全机制,确认是自己的服务器后,点击「继续」。

  5. 弹出密码输入框,输入服务器的 root 账号密码,按回车。

首次连接会在服务器上自动安装 VS Code Server 轻量服务端,等待几十秒即可。左下角状态栏显示 SSH: 服务器IP,就代表连接成功。

4. 打开工作目录

连接成功后,点击左上角「文件」→「打开文件夹」,输入服务器上的工作目录路径,例如网站根目录:

复制代码
/var/www/html

点击确定,再次确认密码后,左侧资源管理器就会显示服务器上的所有文件。点击文件即可编辑,Ctrl + S 保存的同时,文件会自动同步到服务器,刷新浏览器就能看到效果。

四、配置 SSH 公私钥免密登录

每次连接、打开文件夹都要输入密码非常繁琐,配置公私钥免密登录后,一键连接服务器,全程无需输密码。

原理说明

SSH 公私钥是一种非对称加密认证方式:

  • 本地生成「私钥」和「公钥」一对密钥

  • 公钥放到服务器上,私钥留在本地

  • 连接时通过密钥对校验身份,替代密码输入,安全性更高也更方便

步骤 1:Windows 本地生成密钥对

  1. 按下 Win + R,输入 cmd 回车,打开命令提示符。

  2. 执行密钥生成命令:

    复制代码
    ssh-keygen
  3. 连续按 3 次回车:

    • 第一次:确认密钥保存位置,默认路径即可,无需修改

    • 第二次:设置私钥密码(直接回车 = 不设置,本地自用无需设置)

    • 第三次:确认私钥密码,直接回车

生成完成后,会在 C:\Users\你的用户名\.ssh\ 目录下生成两个文件:

  • id_ed25519:私钥,保存在本地,切勿泄露

  • id_ed25519.pub:公钥,需要上传到服务器

步骤 2:将公钥上传到 CentOS 服务器

推荐新手用手动复制法,成功率更高,避免命令行输错密码:

  1. 打开 C:\Users\你的用户名\.ssh\ 目录,用记事本打开 id_ed25519.pub

  2. 全选复制文件内的全部内容(一整行以 ssh-ed25519 开头的字符串,不要漏字符、不多带空行)。

  3. 回到 VSCode 的远程终端,执行命令创建 .ssh 目录:

    复制代码
    mkdir -p ~/.ssh
  4. 将公钥写入服务器的授权文件:

    复制代码
    echo "你复制的公钥内容" >> ~/.ssh/authorized_keys

也可以用命令一键上传(需要输入一次服务器密码):

复制代码
ssh root@服务器IP "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys" < %USERPROFILE%\.ssh\id_ed25519.pub

步骤 3:设置服务器端权限

SSH 对目录和文件的权限要求非常严格,权限不对会拒绝免密登录。在 VSCode 终端执行两条命令:

复制代码
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

执行后没有任何提示就是成功(Linux 中无报错就是操作成功)。

步骤 4:验证免密效果

  1. 关闭当前 VSCode 远程窗口。

  2. 回到本地 VSCode,在远程资源管理器里重新点击连接服务器。

  3. 无需输入密码,直接连上服务器,就代表免密登录配置成功。


五、远程开发使用技巧

  1. 代码实时同步:编辑远程文件后,保存即自动同步到服务器,无需手动上传下载。

  2. 内置终端:按 `Ctrl +`` 调出内置终端,直接就是服务器的命令行,和在虚拟机里操作完全一致。

  3. 扩展远程安装:常用的代码提示、格式化插件,可以选择安装在远程服务器端,不占用本地资源。

  4. 多主机管理:可以添加多台服务器,在远程资源管理器里一键切换,适合管理多台靶场或云服务器。


六、进阶稳定化:禁用 VSCode 自动更新,锁定环境版本

自动更新虽然能带来新功能,但也可能引发插件兼容性问题、界面变动,甚至破坏已稳定的远程开发环境。通过以下配置可以彻底禁用 VSCode 主程序与插件的自动更新,锁定当前版本,保证环境稳定。

方法一:图形界面设置 (推荐)

最直观易操作的方式,在设置面板中即可完成。

  1. 打开设置面板 点击左下角齿轮图标 → 选择「设置」,或直接按快捷键 Ctrl + , 快速打开。

  2. 关闭主程序自动更新 在顶部搜索框输入 update.mode,找到「Update: Mode」下拉菜单,选择 none

  • none:完全关闭所有自动更新,不会自动检查、下载、安装新版本

  • manual:仅保留手动检查入口,不会自动触发更新

  1. 关闭 Windows 后台静默更新 继续搜索 update.enableWindowsBackgroundUpdates取消勾选该选项,防止系统后台偷偷下载安装包。

  2. 关闭扩展插件自动更新 搜索 extensions.autoUpdate,将下拉选项改为 off,避免插件自动升级导致的兼容问题。

所有设置即时生效,无需重启软件。后续如需升级,手动点击左下角齿轮 →「检查更新」即可。

方法二:修改配置文件(一步到位)

适合习惯直接编辑配置的用户,一次性写入所有规则。

  1. Ctrl + Shift + P 调出命令面板

  2. 输入 settings json,选择「首选项:打开用户设置 (JSON)」

  3. 在大括号内添加以下配置项:

复制代码
"update.mode": "none",
"update.enableWindowsBackgroundUpdates": false,
"extensions.autoUpdate": false

Ctrl + S 保存文件,配置立即生效。

方法三:禁用系统计划任务(彻底阻断)

VSCode 会在 Windows 系统中创建自动更新计划任务,即使软件内关闭更新,系统仍可能定时触发检查。从系统层面禁用可彻底杜绝。

  1. Win + R,输入 taskschd.msc 回车,打开「任务计划程序」

  2. 左侧依次展开「任务计划程序库」→「Microsoft」→「Windows」

  3. 找到名称包含 VSCode Automatic Updates 的任务项

  4. 右键点击 → 选择「禁用」


七、常见问题排查

1. 连接超时 / 失败

  • 先在本地 CMD 执行 ping 服务器IP,确认网络能通

  • 在服务器上执行 systemctl status sshd,确认 SSH 服务已启动

  • 检查服务器防火墙是否放行 22 端口

2. 免密不生效,仍需输密码

  • 检查公钥是否完整复制,没有多余换行、空格

  • 确认 ~/.ssh 目录权限为 700,authorized_keys 文件权限为 600

  • 确认公钥放到了对应用户的目录下(root 账号要放在 /root/.ssh

3. 编辑文件提示权限不足

  • 确认使用 root 账号登录

  • 在终端执行 chown -R root:root 目录路径 重置目录所有者

4. 首次连接速度很慢

  • 首次连接需要在服务器安装 VS Code Server,属于正常现象

  • 后续连接会复用服务端,几秒即可完成连接

  • 虚拟机环境建议分配 2G 以上内存、虚拟磁盘放在 SSD 上,可大幅提升速度


总结

完成以上全部配置后,就拥有了一套稳定、高效的远程开发环境:本地用熟悉的 VSCode 写代码,实时同步到 CentOS 服务器,内置终端直接执行命令,全程免密登录,同时锁定版本避免自动更新带来的兼容问题。无论是搭建 Web 靶场、开发 PHP 网页,还是学习 Linux 运维,都能显著提升操作效率。

相关推荐
Databuff4 小时前
PuTTY 工具的开源平替来了,免费使用
运维·开源·ssh·开源软件
Databuff14 小时前
AI SSH工具,集齐SSH、SFTP、知识库RAG、AI助手
网络·人工智能·ssh
郝学胜-神的一滴18 小时前
C++11 工程级应用 09:告别无谓拷贝,解锁高性能移动语义
开发语言·数据结构·c++·vscode·软件工程·visual studio
竣达技术21 小时前
UPS 供电风险保护方案网络远程控制:免代理 SSH/Telnet UPS 安全关机方案
网络·安全·ssh
weixin_402486341 天前
VS Code Codex/Claude Extension 无法安装 / 无法正常打开
linux·服务器·vscode
2501_915909061 天前
SwiftUI 和 UIKit 怎么选?两代 UI 框架的适用范围
vscode·ios·objective-c·个人开发·swift·敏捷流程
golang学习记1 天前
VS Code 新UI被曝重大bug:菜单栏消失了
vscode·bug
2501_915918411 天前
在Windows10上使用VSCode和Code Runner搭建Swift开发环境详细步骤
ide·vscode·ios·objective-c·个人开发·swift·敏捷流程
JeJe同学1 天前
Linux远程服务器网络访问优化:使用SSH反向端口转发共享本地HTTP代理
服务器·网络·ssh