VS Code Dev Containers 修改配置后怎么完整重建容器

VS Code Dev Containers 修改 devcontainer.json、Dockerfile 或 Docker Compose 文件后，不会自动把改动装进当前容器。完整做法是保存配置，打开命令面板运行 Dev Containers: Rebuild Container；如果希望重建结束后自动重新连接工作区，直接选择 Dev Containers: Rebuild and Reopen in Container。重建会回到容器的起始内容，临时手工安装的软件可能消失，因此长期依赖应写入 Dockerfile 或 postCreateCommand。

官方地址：https://code.visualstudio.com/docs/devcontainers/create-dev-container

步骤一：确认配置入口和当前容器状态

在项目窗口按 F1 或 Ctrl+Shift+P 打开命令面板，搜索 Dev Containers。如果要确认配置文件位置，选择 Dev Containers: Open Container Configuration File；如果项目还没有配置，则选择 Dev Containers: Add Dev Container Configuration Files...。重点检查编辑器打开的是当前工作区下的 .devcontainer/devcontainer.json，而不是另一个项目副本。

这一步的可见确认是：命令面板能列出 Dev Containers 命令，资源管理器能看到 .devcontainer，编辑器标签显示 devcontainer.json。如果修改的是 Dockerfile 或 Compose 文件，也要确认它们位于该配置引用的路径中。

步骤二：执行 Rebuild Container

保存所有配置文件后再次打开命令面板。只想重建并保持当前窗口流程时，选择 Dev Containers: Rebuild Container；需要重建完成后重新连接当前工作区时，选择 Dev Containers: Rebuild and Reopen in Container。后者更适合本篇“修改配置后完整生效”的场景。

执行后，窗口会短暂重新加载并显示构建状态。等待状态从 Building container 进入容器连接状态，再检查左下角远程标识、工作区目录和配置中声明的扩展或 Feature。不要只看到窗口刷新就认为成功，必须确认终端已经位于容器内。

步骤三：失败时回到本地查看日志

如果重建弹出错误对话框，先选择 Open Folder Locally，回到本地窗口修改配置，不要在已经失效的容器连接里反复点击。随后按 F1 搜索 Dev Containers: Show Container Log，查看是 Dockerfile 构建、Compose 服务、Feature 安装还是路径引用失败。

日志定位到具体阶段后，只改对应配置并保存。例如 Dockerfile 的安装命令失败，就修正镜像或安装参数；Compose 服务名变化，就同步 devcontainer.json 的 service 字段。修完后运行 Dev Containers: Rebuild and Reopen in Container，不要把“重新打开容器”当成重新构建。

步骤四：重建后核对最终状态

进入容器后依次确认三件事：终端当前目录是容器工作区；配置声明的扩展、Feature 或工具已经可用；本次新增的软件不是只在上一个容器里手工安装的临时内容。若重建后工具消失，应把安装动作写入 Dockerfile，或把依赖工作区文件的安装放进 postCreateCommand，然后再次重建。

常见问题

只改 devcontainer.json 也需要完整重建吗？

如果改动影响镜像、Feature、挂载、端口、用户或扩展配置，应执行 Rebuild。仅修改容器内普通工作区代码，不需要重建容器。

Rebuild Container 和 Rebuild and Reopen in Container 有什么区别？

前者负责重建，后者在重建后继续把当前窗口重新连接到容器。要让本次配置改动从构建到连接完整闭环，优先选择后者。

记住“确认配置入口、保存后重建、失败回本地看日志、进入容器核对结果”这四步，就能避免把窗口刷新误判为配置已经生效。