要在本地 VS Code 编辑远程服务器代码,需安装 Remote-SSH 扩展、配置 SSH 主机信息、建立连接、设置免密登录,必要时手动部署 VS Code Server。

如果您希望在本地计算机上使用 Visual Studio Code 编辑远程服务器上的代码,则需要通过 SSH 协议建立安全连接。以下是完成此操作的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 Remote-SSH 扩展
Remote-SSH 是 VSCode 官方提供的扩展,用于在本地 VSCode 中直接访问和编辑远程主机的文件系统。该扩展依赖 OpenSSH 客户端,需确保系统已预装或手动配置 SSH 工具。
1、打开 VSCode,点击左侧活动栏中的扩展图标(四个方块组成的图标)。
2、在搜索框中输入 Remote-SSH,找到由 Microsoft 发布的官方扩展。
3、点击“安装”按钮,等待扩展下载并启用。
二、配置 SSH 主机连接信息
VSCode 通过读取本地的 SSH 配置文件(~/.ssh/config)或内置连接向导来识别远程服务器地址、端口、用户名等参数。正确配置后,可快速复用连接。
1、按下 Command+Shift+P(Mac)或 Ctrl+Shift+P(Windows/Linux),打开命令面板。
2、输入并选择 Remote-SSH: Connect to Host...。
3、选择 Configure SSH Hosts...,然后选择用户级配置文件 ~/.ssh/config。
4、在打开的配置文件中添加如下内容:
Host my-server
HostName 192.168.1.100
User ubuntu
Port 22
专为中小型企业定制的网络办公软件,富有竞争力的十大特性: 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装,建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件,使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件,提供web方式的远程邮件服务。 4、集成语音会议组件,节省长途话费开支。 5、集成手机短信组件,重要信息可直接发送到员工手机。 6、集成网络硬
三、建立首次远程连接
首次连接时,VSCode 将自动在远程服务器上部署 VS Code Server 组件,该组件负责与本地客户端通信。整个过程需网络通畅且远程主机允许 SSH 登录及写入权限。
1、再次调出命令面板,执行 Remote-SSH: Connect to Host...。
2、从列表中选择刚配置的 my-server。
3、若提示输入密码,输入对应用户的 SSH 登录密码;若配置了密钥认证,则自动完成身份验证。
4、等待右下角状态栏显示 SSH: my-server,表示连接成功并已加载远程工作区。
四、使用本地密钥对进行免密登录
为避免每次连接重复输入密码,可将本地生成的 SSH 公钥上传至远程服务器的授权密钥列表。此方式依赖 OpenSSH 的密钥管理机制,安全性更高且操作一次即可长期生效。
1、在终端中执行 ssh-keygen -t ed25519 生成新密钥对,默认保存在 ~/.ssh/id_ed25519。
2、执行 ssh-copy-id -i ~/.ssh/id_ed25519.pub ubuntu@192.168.1.100,将公钥复制到目标服务器。
3、修改 ~/.ssh/config 文件,在对应 Host 段落下添加一行:IdentityFile ~/.ssh/id_ed25519。
五、手动部署 VS Code Server(当自动部署失败时)
某些受限环境(如无 curl/wget、无 root 权限、防火墙拦截下载)可能导致 VS Code Server 自动安装失败。此时可手动下载对应版本的 server 压缩包,并解压至远程服务器指定路径。
1、访问 https://update.code.visualstudio.com/commit:COMMIT_ID/server-linux-x64/stable,其中 COMMIT_ID 可在 VSCode 关于界面中查得。
2、在远程服务器上创建目录:mkdir -p ~/.vscode-server/bin/COMMIT_ID。
3、将下载的 tar.gz 文件上传至该目录,并执行:tar -xzf code-server.tar.gz -C ~/.vscode-server/bin/COMMIT_ID --strip=1。







