VSCode Remote Development通过Remote-SSH、Remote-Containers和Remote-WSL扩展实现远程开发：先安装扩展包，再依SSH连接服务器、在Docker容器启动环境、或附加到运行中容器。
如果您希望在远程服务器、虚拟机或容器中直接进行代码编辑和调试，VSCode Remote Development 提供了一种无缝的本地化开发体验。以下是实现该能力的核心机制与配置路径：
本文运行环境：MacBook Pro，macOS Sequoia
一、安装Remote Development扩展包
VSCode本身不内置远程开发能力，需通过官方扩展包启用SSH、WSL及容器支持。该扩展包整合了Remote-SSH、Remote-Containers和Remote-WSL三个子扩展，统一管理远程连接逻辑。
1、启动VSCode，点击左侧活动栏的扩展图标（或使用快捷键Cmd+Shift+X）。
2、在搜索框中输入Remote Development，找到由Microsoft发布的官方扩展。
3、点击“安装”按钮，等待扩展下载并自动启用。
二、通过SSH连接远程Linux服务器
该方式适用于已部署SSH服务的物理机、云服务器或树莓派等设备，VSCode将在远程主机上部署服务端组件，本地仅保留UI层。
1、确保远程机器已开启SSH服务，并可通过终端执行ssh user@host成功登录。
2、在VSCode命令面板（Cmd+Shift+P）中输入并选择“Remote-SSH: Connect to Host…”。
3、首次使用时选择“Add New SSH Host…”，输入格式为user@ip_address，例如ubuntu@192.168.1.50。
4、选择对应SSH配置文件位置（默认~/.ssh/config），VSCode将自动生成连接条目。
三、在Docker容器内启动开发环境
该方法将代码目录挂载进预配置的容器，所有依赖、工具链和运行时均隔离于容器中，避免污染宿主系统。
1、确保本地已安装Docker Desktop并处于运行状态。
2、在项目根目录下创建.devcontainer/devcontainer.json文件，定义容器镜像、端口映射与扩展列表。
3、按Cmd+Shift+P打开命令面板，执行“Dev Containers: Reopen in Container”。
4、VSCode自动构建镜像（如未缓存）、启动容器，并在其中安装指定扩展与配置开发环境。
四、接入已运行的容器实例
当已有容器正在后台运行且需复用其环境时，可跳过重建流程，直接附加到该容器的文件系统与进程空间。
1、在终端中执行docker ps获取目标容器ID或名称。
2、在VSCode命令面板中选择“Dev Containers: Attach to Running Container…”。
3、从列表中选择目标容器，VSCode将注入VS Code Server并挂载工作区路径。
4、打开文件夹后，所有编辑操作实时作用于容器内部的对应路径。
