这篇教程适合：你希望把本地电脑当成“轻终端”，代码与依赖都放在远程主机（云服务器/家用小主机/NAS/公司内网机器）上；同时又想保留 VS Code 的补全、调试、插件生态，并且让环境可复刻、可交接。
Remote SSH 解决的是“编辑器连到远程机器跑代码”；Dev Containers 解决的是“远程机器上的项目依赖，用容器隔离并固化成模板”。两者合起来的效果是：你用 VS Code 写代码，但实际执行环境由 .devcontainer 描述，团队成员拉下项目就能快速一致化。
1) 本地安装 VS Code，并确保能正常联网更新扩展。
2) 远程主机准备好 SSH 登录（Linux/WSL/Linux VM 都可）。建议为开发单独建用户，避免直接用 root。
3) 若要用容器：远程主机需安装 Docker（或兼容的容器运行时）。如果是生产机，建议单独一台“开发机”，避免开发容器影响线上环境。
4) 准备 SSH 密钥（推荐）而不是只用密码。生成密钥示例（本地执行）：ssh-keygen -t ed25519 -C "dev"
1) 在 VS Code 扩展市场安装：Remote - SSH。
2) 打开命令面板，选择：Remote-SSH: Connect to Host...，然后添加主机信息。
3) 推荐用 ~/.ssh/config 管理主机别名，示例：
Host dev-box HostName 203.0.113.10 User dev Port 22 IdentityFile ~/.ssh/id_ed25519
4) 首次连接会在远程侧安装 VS Code Server，等待完成即可打开远程工作区。
小提示：如果你经常切网络（公司/家里/手机热点），把主机写成域名或内网穿透的稳定地址会更省心，但要确保合规与权限许可。
1) 在远程工作区里安装扩展：Dev Containers。
2) 在项目根目录创建 .devcontainer/devcontainer.json。一个通用、易改的起步模板：
{ "name": "my-project", "image": "mcr.microsoft.com/devcontainers/ :ubuntu", "features": { "ghcr.io/devcontainers/features/node:1": {"version": "lts"} }, "postCreateCommand": "node -v && npm -v", "customizations": { "vscode": { "extensions": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"] } } }
3) 回到命令面板，选择：Dev Containers: Reopen in Container。VS Code 会在远程机上拉镜像、创建容器，并把项目挂载进去。
4) 环境固化后，把 .devcontainer 目录提交到仓库。别人只要能 SSH 到同一类开发机，也能“一键复刻”。
1) 连接慢/卡在安装 Server：优先检查远程机磁盘空间与网络。也可以在 VS Code 里查看 Remote-SSH 输出日志，确认卡在哪一步。
2) 容器内权限问题：避免在容器里用 root 写入挂载目录导致宿主权限混乱；必要时在 devcontainer 里设置用户映射，或把工作目录放到明确的开发路径。
3) 端口转发怎么做：Web 服务跑在远程容器内时，可在 VS Code 端口面板转发到本地；这属于常规开发调试能力，不涉及任何绕过权限的操作。
4) 代理与镜像源：如果拉镜像慢，优先使用公司/家里合规的镜像加速方案；不要使用来路不明的镜像源。
1) 每个项目都写清 postCreateCommand，把依赖安装与初始化脚本显式化。
2) 把常用扩展写进 customizations.vscode.extensions，避免“环境复刻只复刻了依赖，没复刻编辑体验”。
3) 为远程开发机做好资源边界：CPU/内存/磁盘配额，避免容器一多就互相拖慢。
4) 把“开发”和“生产”隔离：同一台机器混用会带来权限与稳定性风险。
VS Code Remote SSH 官方文档：https://code.visualstudio.com/docs/remote/ssh
Dev Containers 规范（containers.dev）：https://containers.dev/
本文仅用于合法合规的开发环境搭建与效率提升，不包含任何攻击、入侵、破解或绕过付费的细节。
