VS Code Remote 怎样打开远程工作区文件夹

想在 VS Code 里打开服务器上的项目，关键不是先在本地选择一个目录，而是先建立 Remote-SSH 连接。连接成功后，执行 File > Open Folder...，目录选择器看到的就是远程主机文件系统；打开后，资源管理器、远程扩展和集成终端都会围绕这个远程工作区工作。

官方地址：https://code.visualstudio.com/docs/remote/ssh

先确认远程连接入口已经准备好

本机需要安装 VS Code，并安装官方的 Remote - SSH 扩展。远程端需要运行 SSH 服务，本机也要有可用的 OpenSSH 客户端。首次连接时，VS Code 可能会在远程主机部署 VS Code Server；这一步完成之前，不要急着在本地窗口里打开项目目录。

按 F1 或 Ctrl+Shift+P（macOS 为 ⇧⌘P），输入 Remote-SSH: Connect to Host...。如果列表里还没有目标主机，可以选择添加主机，输入类似下面的连接命令：

# 只用占位主机名演示连接格式，不包含真实账号或地址
ssh devuser@dev-host

选择主机后，VS Code 会打开一个新的远程窗口。遇到平台选择提示时，按远程主机的实际系统选择；连接进度和失败原因可以从 Remote - SSH 输出通道查看。

连接成功后从远程窗口打开文件夹

连接完成后，先看窗口左下角或状态栏是否显示当前远程主机。确认窗口已经切到远程环境，再从顶部菜单选择 File > Open Folder...。随后在目录选择器中找到服务器上的项目目录并确认。

也可以打开 Remote Explorer，在 SSH Targets 中展开主机，使用主机旁边的打开文件夹入口。这个方式适合经常访问同一个远程项目，但第一次连接仍然要先完成主机认证。

打开目录时只填写远程文件系统中的路径，例如 /srv/projects/demo。不要把本机的 /Users/... 或 C:\\Users\\... 路径当成远程项目路径；两者属于不同的文件系统。

用三处状态确认工作区确实在远程主机

目录打开后，可以按下面的清单快速核对。只看到文件树还不够，因为本地窗口也能显示相似的项目结构。

远程扩展通常会显示在对应 SSH 主机的扩展分组中。需要依赖远程运行环境的扩展，应安装到远程主机，而不是只安装在本地 UI 端。

路径不对、连接卡住或需要退出时怎么处理

如果找不到目标目录，先在远程窗口打开新终端，用远程账号确认目录层级，再回到 File > Open Folder... 重新选择。不要通过修改本机路径来“猜”远程位置。

如果连接一直停在初始化阶段，打开 View > Output，把输出通道切换到 Remote - SSH，重点看 SSH 认证、远程系统类型和 VS Code Server 初始化信息。只有确认主机可登录后，才继续检查目录权限。

编辑完成后，从菜单选择 File > Close Remote Connection；也可以直接退出 VS Code。关闭连接不会把远程文件夹变成本地副本，重新连接时仍需从 Remote-SSH 进入。

常见问题

连接成功后为什么还是空窗口？

Remote-SSH 连接只建立了远程窗口，不会自动替你选择项目目录。继续执行 File > Open Folder...，在远程主机上选择工作区文件夹即可。

打开文件夹后，终端为什么仍然像本地终端？

重新选择 Terminal > New Terminal，并查看状态栏主机标识。Remote-SSH 窗口中的新终端会在远程主机运行；如果当前窗口没有远程标识，说明你可能切回了本地窗口。

能不能直接用本地资源管理器打开远程路径？

不能把远程 SSH 路径当成本地普通目录处理。应先通过 Remote-SSH 连接，再由 VS Code 的远程窗口打开文件夹，这样扩展、终端和文件操作才会落在远程环境。