可利用 VSCode 的 Dev Containers 功能在 Docker 容器中隔离开发,需安装 Docker Desktop、Dev Containers 扩展和 git;支持自动生成配置、自定义 Dockerfile、附加运行容器、端口转发及容器内调试。

如果您希望在隔离的环境中进行代码开发与调试,同时保持本地开发体验的一致性,则可以利用 VSCode 的 Dev Containers 功能将开发环境直接运行于 Docker 容器内。以下是实现该目标的具体方法:
本文运行环境:MacBook Pro,macOS Sequoia。
一、安装必要组件
启用容器化开发前,需确保本地已安装支持 Dev Containers 的核心工具链。VSCode 通过这些组件与 Docker 守护进程通信,并构建、启动及连接开发容器。
1、下载并安装最新稳定版 Docker Desktop,安装过程中启用 Docker Engine 和 Kubernetes(可选)。
2、打开 VSCode,进入扩展市场,搜索并安装官方扩展 Dev Containers(由 Microsoft 发布,图标为蓝色容器)。
3、确认系统中已安装 git 命令行工具,用于克隆项目及初始化容器配置。
二、基于现有项目启用 Dev Container
当项目尚未包含 Dev Container 配置时,VSCode 可自动生成适配的 .devcontainer/devcontainer.json 文件,并据此构建容器环境。该方式适用于快速启动标准化开发环境。
1、在 VSCode 中打开目标项目文件夹。
2、按下 Command + Shift + P(macOS)调出命令面板,输入并选择 Dev Containers: Add Development Container Configuration Files...。
3、从模板列表中选择匹配项目语言的配置,例如 Node.js & TypeScript 或 Python 3。
4、VSCode 自动在项目根目录下创建 .devcontainer 文件夹及 devcontainer.json 和 Dockerfile(如适用)。
三、使用自定义 Dockerfile 构建容器
当标准模板无法满足依赖或运行时要求时,可通过编写自定义 Dockerfile 精确控制基础镜像、系统包、工具链及权限设置,从而构建完全可控的开发环境。
1、在 .devcontainer 目录中新建文件 Dockerfile,内容以 FROM 指令起始,例如 FROM mcr.microsoft.com/vscode/devcontainers/python:3-3.11。
Angel工作室企业网站管理系统全DIV+CSS模板,中英文显示,防注入sql关键字过滤,多浏览器适应,完美兼容IE6-IE8,火狐,谷歌等符合标准的浏览器,模板样式集中在一个CSS样式中,内容与样式完全分离,方便网站设计人员开发模板与管理。系统较为安全,以设计防注入,敏感字符屏蔽。新闻,产品,单页独立关键字设计,提高搜索引擎收录。内置IIS测试,双击打启动预览网站 Angel工作室企业网站
2、在 Dockerfile 中添加 RUN 指令安装额外依赖,例如 RUN apt-get update && apt-get install -y curl jq。
3、修改 devcontainer.json,将 image 字段替换为 build 对象,指定 dockerfile 路径与 context 范围。
四、附加到正在运行的容器进行调试
对于已在宿主机上运行的容器(如通过 docker run 或 docker-compose 启动),VSCode 支持直接附加调试器,无需重建环境,适用于复现线上问题或调试已部署服务。
1、确保目标容器已以交互模式运行,并挂载了源码目录,例如使用 -v $(pwd):/workspace 参数。
2、在 VSCode 中执行命令 Dev Containers: Attach to Running Container...。
3、从列表中选择目标容器,VSCode 将自动检测运行时并安装对应平台的 VS Code Server。
4、附加成功后,可在容器内直接打开文件、设置断点、启动调试会话,并查看容器内的进程与日志输出。
五、配置端口转发与调试启动项
开发过程中常需访问容器内运行的服务(如本地 Web 服务器或 API),VSCode 提供端口自动转发机制,并支持在 launch.json 中定义调试入口,实现一键启动与调试。
1、在 devcontainer.json 的 forwardPorts 数组中添加端口号,例如 3000 或 8080,保存后 VSCode 自动建立转发隧道。
2、在容器内打开项目文件夹后,点击左侧活动栏的调试图标,选择 create a launch.json file。
3、根据运行时选择对应环境模板(如 Python 或 Node.js),编辑 program 字段指向入口文件,例如 "program": "./app.py"。
4、按 F5 启动调试,VSCode 将在容器内执行程序并同步调试状态。









