Cmd+Shift+P→Remote-Containers: Reopen in Container是VSCode Docker开发唯一可靠入口，它读取.devcontainer/devcontainer.json，决定拉取或构建镜像并挂载工作区；修改配置后须用Rebuild and Reopen强制更新，否则旧容器持续运行。
VSCode 的快捷键在 Docker 开发中不是“额外功能”，而是触发核心工作流的开关——真正起作用的不是按键本身，而是它背后调用的 Remote-Containers 命令。记错或跳过关键组合，会导致配置不生效、容器没重建、调试连不上。
Cmd+Shift+P → Remote-Containers: Reopen in Container 是唯一可靠入口
这个命令是所有容器化开发动作的起点。它会读取 .devcontainer/devcontainer.json，决定是拉取镜像还是构建 Dockerfile，并挂载当前工作区。如果直接点左下角绿色按钮，有时会跳过配置重载，尤其在修改过 devcontainer.json 后。
- 必须确保当前打开的是项目根目录（不是子文件夹），否则 VSCode 找不到
.devcontainer - 首次运行时若提示“未检测到配置”，说明
.devcontainer文件夹不存在或路径不对，别硬按，先检查结构 - 执行后终端里出现
Starting container但卡住超过 2 分钟，大概率是网络问题拉不到镜像，可手动docker pull mcr.microsoft.com/vscode/devcontainers/node:18预热
Cmd+Shift+P → Remote-Containers: Rebuild and Reopen in Container 解决环境变更失效
改了 Dockerfile 或 devcontainer.json 里的 customizations.vscode.extensions，光重启 VSCode 没用。必须用这个命令强制重建镜像并重载窗口，否则旧容器还在跑，新配置不会生效。
-
Rebuild会删掉旧容器和对应镜像层，但保留你本地workspace中的代码文件（因为是 volume 挂载） - 如果看到错误
ERROR: failed to solve: node_modules: not found，说明Dockerfile里 COPY 顺序错了——不能在RUN npm install前就把整个项目 COPY 进去，应先 COPYpackage.json和package-lock.json - 重建耗时较长时，可以开个终端执行
docker images | grep devcontainer看镜像 ID 是否在变，确认流程没卡死
F5 启动调试前，必须确认 launch.json 里 type 是 attach 而非 launch
容器内调试不是本地运行再连过去，而是 VSCode 主动 attach 到容器里已启动的进程。如果 launch.json 里写的是 "type": "node" 或 "type": "python"，F5 会尝试在宿主机上找解释器，必然失败。
- 正确配置示例：
"type": "pwa-node"+"request": "attach"+"port": 9229（Node.js）或"type": "python"+"request": "attach"（Python） - 容器内服务必须显式监听
0.0.0.0:9229，不能只写127.0.0.1:9229，否则 VSCode 连不上 - 端口转发必须提前配好：
devcontainer.json里要有"forwardPorts": [9229]，否则即使进程开了，宿主机也收不到包
真正容易被忽略的不是快捷键本身，而是每个快捷键背后依赖的配置完整性：devcontainer.json 是否有 forwardPorts，Dockerfile 是否暴露了端口，容器内进程是否真的在监听外部地址。少一个环节，F5 就只是安静地失败。
