VS Code远程开发必须安装Remote Development插件包，它自动集成Remote - SSH和Remote - Containers；缺任一都将导致连接失败、文件无法打开或扩展失效。
VS Code 远程开发必须装的插件只有这 3 个
远程连接容器或服务器跑 VS Code，Remote - SSH、Remote - Containers、Remote Development 这三个插件是硬性依赖。缺任何一个，都连不上、打不开文件、或者扩展全失效。
其中 Remote Development 是父级扩展包，它本身不直接提供功能，但会自动拉取并管理另外两个；如果你只装了 Remote - SSH 却没装它，某些版本下会出现“找不到 Remote-Containers 命令”的报错；反过来，单独装 Remote - Containers 而不启用 Remote Development，也会导致容器内扩展无法加载。
-
Remote - SSH：用于通过 SSH 连远程 Linux 服务器（比如你家里的 NAS 或树莓派） -
Remote - Containers：用于打开本地或远程 Docker 容器内的项目（私有云部署最常用路径） - 所有远程场景下，
Remote Development必须启用，否则其他两个插件的 UI 入口和命令面板条目不会出现
别急着装“AI 编程助手”，先确认运行环境是否就绪
很多用户一上来就搜 Amazon Q、Claude Code 或 GitHub Copilot，结果在容器里反复报错：Extension host terminated unexpectedly 或 Cannot connect to the extension host。根本原因不是插件本身有问题，而是容器里缺基础依赖。
私有云部署中常见的容器镜像（比如 codercom/code-server、gitpod-io/gitpod 或自建的 vscode-server 镜像），默认不带 Node.js 运行时、不挂载 /root/.vscode-server 持久化路径、也不开放 WebSocket 端口——而这三样恰恰是 AI 插件运行的前提。
- 确认容器启动时是否映射了
HOST_CONFIG_PATH和HOST_LOG_PATH（参考.env中的HOST_CONFIG_PATH=./config） - 检查容器内是否已安装
node：执行docker exec -it <container> node --version</container>，低于 v18 就得升级 - AI 插件首次激活时会下载大模型适配层，如果容器网络受限（比如没配
--network=host或 DNS 不通），会卡在“installing dependencies”
私有云场景下，这些插件反而更实用
比起花哨的 AI 补全，私有云部署真正高频用到的是文件同步、服务管理、配置校验类插件。它们不依赖外部 API，稳定、轻量、离线可用。
-
SFTP：直接编辑远程私有云服务器上的配置文件（如/etc/hosts、Nginx 配置），不用反复scp上传下载 -
Docker（由 Microsoft 官方维护）：在 VS Code 侧边栏直接查看容器状态、进容器终端、看日志，比敲docker ps直观得多 -
Settings Sync：用 GitHub Gist 同步你的 VS Code 配置（包括插件列表、快捷键、主题），换一台机器重装后一键恢复，避免每次都要手动重装 - 慎用
PHP Intelephense或Python这类语言服务插件——除非你确定容器里已装好对应解释器且 PATH 正确，否则只会报Cannot resolve python interpreter
插件持久化失败？大概率是容器卷没挂对
重启容器后发现所有插件都没了，或者设置全回退，默认主题变回暗色——这不是插件问题，是 VS Code Server 的数据目录没持久化。它默认把扩展、配置、缓存全写在容器内部的 /root/.vscode-server 下，一删容器就清空。
解决办法只有一个：确保 docker run 命令或 compose.yml 中挂载了该路径。例如：
docker run -d \ -v $(pwd)/vscode-data:/root/.vscode-server \ -p 8555:8080 \ codercom/code-server:4.99
注意路径必须是绝对路径，./vscode-data 在某些 shell 下可能解析失败；另外不要挂载到 /root 根目录，否则容器启动会因权限问题失败。
真正的麻烦点在于：不同镜像对配置路径的约定不一致。code-server 用 /root/.vscode-server，而 gitpod-io/gitpod 默认走 /workspace/.vscode-server，改错地方就会白挂。
