<p>通过安装VS Code的Remote – Containers插件并配置devcontainer.json文件,可实现对容器内开发环境的无缝连接与调试,支持使用现有镜像或自定义dockerfile构建开发容器,在容器中运行、调试代码并实时同步更改,提升开发一致性与效率。</p>

如果您尝试在本地开发环境中使用容器化应用,但无法直接访问或调试容器内的服务,则可能是由于缺少合适的开发工具支持。通过 visual studio Code 的容器开发插件,可以实现对容器内部环境的无缝连接与管理。
本文运行环境:Dell XPS 13,windows 11
一、安装 Remote – Containers 插件
Remote – Containers 是 VS Code 官方提供的扩展,允许开发者将整个开发环境置于容器中,从而实现环境一致性与可移植性。
1、打开 VS Code 编辑器,点击左侧活动栏中的扩展图标(四个方块组成的图标)。
2、在搜索框中输入 Remote – Containers。
3、找到由 microsoft 发布的官方插件,点击“安装”按钮完成下载和集成。
二、配置 devcontainer.json 文件
该文件用于定义容器的构建参数、依赖项及启动配置,确保开发环境按需初始化。
1、在项目根目录下创建名为 .devcontainer 的文件夹。
2、在该文件夹内新建一个 devcontainer.json 配置文件。
3、填写基础镜像、端口转发、扩展自动安装等设置,例如指定 ubuntu 镜像并预装 python 支持。
三、使用已有 Docker 镜像启动开发容器
若团队已提供标准化镜像,可直接基于该镜像启动开发环境,避免重复配置。
1、确保本地已安装并运行 Docker Desktop。
2、在命令面板(Ctrl+Shift+P)中输入 Reopen in Container。
3、选择已存在的镜像作为开发容器基础,VS Code 将自动拉取镜像并启动隔离环境。
四、构建自定义开发镜像
当默认镜像无法满足需求时,可通过 Dockerfile 定制专属开发环境,包含特定工具链和依赖。
1、在 .devcontainer 文件夹中创建 Dockerfile 文件。
2、编写指令安装必要软件包,如 node.js、gcc 或数据库客户端。
3、更新 devcontainer.json 中的 context 和 dockerFile 路径指向新文件,重新打开容器即可触发构建流程。
五、在容器内运行和调试代码
一旦容器成功启动,所有文件操作和终端命令都将执行于容器内部,实现真正的隔离开发体验。
1、打开集成终端(Ctrl+`),验证当前运行环境的操作系统和工具版本。
2、使用内置调试器设置断点并启动调试会话,调试进程将在容器中运行。
3、修改代码后保存,变更将实时同步至容器,支持热重载的应用可立即查看效果。