要在本地 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
三、建立首次远程连接
首次连接时，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。
