可通过 Remote-SSH、SFTP 扩展或 Remote Explorer 的 WSL/ 容器支持三种方式实现 VSCode 远程文件浏览编辑:Remote-SSH 需配置 SSH 主机并连接;SFTP 扩展通过 sftp.json 映射远程路径;WSL/ 容器支持则直接挂载本地环境文件系统。

如果您在 VSCode 中使用“远程 资源管理器”扩展访问远程服务器,但无法像操作本地文件那样浏览、编辑或保存远程文件,则可能是由于远程开发环境未正确配置或 SSH 连接异常。以下是实现该功能的多种方法:
本文运行环境:MacBook Air,macOS Sequoia。
一、通过 Remote-SSH 扩展建立稳定连接
Remote-SSH 是 VSCode 官方提供的远程开发方案,它允许您将 VSCode 的 UI 与远程主机的文件系统和终端完全集成,从而实现本地化操作体验。
1、打开 VSCode,点击左侧活动栏的“远程资源管理器”图标(地球形状)。
2、点击顶部的“+”号,选择“Connect to Host…”,然后选择“Configure SSH Hosts…”。
3、在弹出的配置文件中添加类似以下内容:Host my-servern HostName 192.168.1.100n User ubuntun IdentityFile ~/.ssh/id_rsa。
4、保存后,在“远程资源管理器”中点击该主机名,输入密码或确认密钥授权,等待连接成功。
二、使用 SFTP 扩展挂载远程目录为本地工作区
SFTP 扩展可在不启动完整远程开发会话的前提下,将远程路径映射为可读写的本地式资源视图,适用于仅需文件同步与快速编辑的场景。
1、在 VSCode 扩展市场中搜索并安装 SFTP 扩展(作者:liximomo)。
2、按下 Cmd+Shift+P(Mac)调出命令面板,输入并选择“SFTP: Config”。
3、在生成的 sftp.json 文件中填写远程主机信息,其中 “remotePath”: “/home/ubuntu/project” 必须准确指定目标目录。
4、右键点击远程资源管理器中的连接条目,选择“Upload Folder”或直接拖入本地文件至远程路径区域即可同步。
三、启用 Remote Explorer 内置的 WSL 或容器支持
当远程目标为本地 WSL 实例或 Docker 容器时,“远程资源管理器”可跳过网络配置,直接利用本地进程通信机制加载文件系统,延迟更低且无需 SSH 密钥管理。
1、确保已安装 WSL2 并运行 Ubuntu 发行版,或已部署目标镜像的 Docker 容器。
2、点击“远程资源管理器”底部状态栏的“Open a Remote Window”按钮(地球 + 加号)。
3、选择“WSL: Ubuntu”或“Dev Container: Reopen in Container”,VSCode 将自动挂载对应根文件系统。
4、此时左侧资源管理器中显示的文件路径前缀为 /home/ubuntu/ 或 /workspace/,所有操作均实时作用于远程环境。