可通过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-server\n HostName 192.168.1.100\n User ubuntu\n IdentityFile ~/.ssh/id_rsa。
4、保存后,在“远程资源管理器”中点击该主机名,输入密码或确认密钥授权,等待连接成功。
二、使用 SFTP 扩展挂载远程目录为本地工作区
SFTP 扩展可在不启动完整远程开发会话的前提下,将远程路径映射为可读写的本地式资源视图,适用于仅需文件同步与快速编辑的场景。
1、在 VSCode 扩展市场中搜索并安装 SFTP 扩展(作者:liximomo)。
一个功能强大、性能卓越的企业建站系统。使用静态网页技术大大减轻了服务器负担、加快网页的显示速度、提高搜索引擎推广效果。本系统的特点自定义模块多样化、速度快、占用服务器资源小、扩展性强,能方便快捷地建立您的企业展示平台。简便高效的管理操作从用户使用的角度考虑,对功能的操作方便性进行了设计改造。使用户管理的工作量减小。网站互动数据可导出Word文档,邮件同步发送功能可将互动信息推送到指定邮箱,加快企业
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/,所有操作均实时作用于远程环境。









