VSCode Remote-SSH扩展可实现本地编辑器远程开发：安装扩展后，配置SSH主机连接，通过命令面板连接并打开远程文件夹，同步安装远程扩展，并调整自动保存与同步写入设置以保障一致性。
如果您希望在本地 vscode 编辑器中直接操作远程服务器上的代码，同时获得与编辑本地文件一致的语法高亮、智能提示和调试体验，则 vscode 的 remote-ssh 扩展可将远程开发环境无缝集成到本地界面。以下是实现该体验的具体配置与操作路径：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 Remote-SSH 扩展
Remote-SSH 是微软官方维护的核心扩展，它通过 SSH 协议建立安全隧道，在远程主机上部署 VSCode Server，并将本地 UI 与远程后端服务桥接，从而实现真正的远程工作区挂载。
1、启动 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Cmd+Shift+X）。
2、在扩展搜索框中输入 Remote - SSH，找到由 Microsoft 发布的官方扩展。
3、点击“安装”按钮，等待扩展下载并自动启用。
二、配置 SSH 主机连接
VSCode 依赖系统已有的 SSH 配置或手动定义的连接参数来识别目标服务器；配置信息存储于 ~/.ssh/config 文件中，VSCode 会自动读取该文件以生成连接列表。
1、打开终端，执行 ssh-keygen -t ed25519 生成密钥对（若尚未配置免密登录）。
2、使用 ssh-copy-id user@host 将公钥上传至远程服务器。
3、编辑 ~/.ssh/config 文件，添加如下内容：
Host my-server
HostName 192.168.1.100
User ubuntu
IdentityFile ~/.ssh/id_ed25519
三、连接并打开远程文件夹
连接成功后，VSCode 将在远程主机上自动部署 vscode-server，所有编辑、保存、Git 操作均实时作用于远程文件系统，本地仅承担 UI 渲染与指令转发职责。
1、按下 Cmd+Shift+P 打开命令面板，输入 Remote-SSH: Connect to Host... 并回车。
2、从下拉列表中选择已配置的主机名（如 my-server）。
3、首次连接时，VSCode 会在远程服务器的 ~/.vscode-server 目录下自动下载并解压匹配版本的服务端组件。
4、连接建立后，点击“Open Folder”，选择远程路径（例如 /home/ubuntu/project），即可加载完整工作区。
四、启用本地扩展同步
部分扩展（如 Prettier、ESLint）需在远程环境中运行才能生效；VSCode 提供“设为远程扩展”功能，确保其二进制逻辑实际执行于服务器端，而非本地模拟。
1、在扩展视图中，找到目标扩展（如 ESLint）。
2、右键点击该扩展条目，选择 Install on SSH: my-server。
3、重新加载远程窗口（Cmd+Shift+P → “Developer: Reload Window”），使扩展生效。
五、调整文件保存行为以保障一致性
默认情况下，VSCode 在远程模式下采用“延迟写入”策略，可能造成本地 UI 显示与远程磁盘状态短暂不一致；显式启用同步保存可消除该风险。
1、按下 Cmd+, 打开设置界面。
2、搜索 files.autoSave，将其值设为 onFocusChange 或 onWindowBlur。
3、再搜索 files.syncWrite，勾选该项以强制每次保存都等待远程磁盘确认完成。
