如果您希望在隔离的容器环境中进行代码开发与调试，同时保留本地编辑器的高效体验，则可以利用 VSCode 的远程开发功能直接连接到 Docker 容器。以下是实现 VSCode 与 Docker 无缝集成的具体操作步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、使用 Dev Containers 扩展启动容器化开发环境
Dev Containers 是 VSCode 官方提供的扩展，它能根据定义的配置文件自动构建并附加到容器中，使整个工作区在容器内运行，同时保持本地 UI 交互。
1、在 VSCode 中打开命令面板（Cmd+Shift+P），输入并选择“Dev Containers: Add Development Container Configuration Files…”。
2、从模板列表中选择对应项目类型，例如“Node.js”或“Python 3”，VSCode 将自动生成 .devcontainer/devcontainer.json 和 Dockerfile。
3、修改 devcontainer.json 中的 “runArgs” 字段，添加 --privileged 或挂载宿主机 Docker 套接字（"/var/run/docker.sock:/var/run/docker.sock"）以支持容器内调用 Docker CLI。
4、执行“Dev Containers: Reopen in Container”，VSCode 将拉取镜像、构建容器并重新加载窗口。
二、手动附加到已运行的容器
当已有正在运行的容器且未通过 Dev Containers 初始化时，可直接附加 VSCode 到该容器内部，复用其文件系统与运行时环境。
1、确保目标容器已安装 OpenSSH 服务或 VSCode Server 所需依赖（如 curl、tar、unzip）。
2、在终端中执行 docker exec -it
3、在 VSCode 中打开命令面板，选择“Remote-Containers: Attach to Running Container…”。
4、从下拉列表中选择目标容器，VSCode 将自动部署 server 并映射工作区路径。
三、配置容器内调试器支持
VSCode 调试器需识别容器内的运行时路径和端口映射关系，通过 launch.json 显式声明调试配置可避免断点失效或进程无法附加的问题。
1、在容器内打开项目根目录，在 .vscode/launch.json 中添加配置项，例如 Node.js 的 attach 模式需设置 "port": 9229 与 "address": "0.0.0.0"。
2、启动容器时使用 -p 9229:9229 映射调试端口，并在应用启动命令后追加 --inspect=0.0.0.0:9229 参数。
3、在 VSCode 调试侧边栏选择对应配置，点击绿色三角形启动调试会话。
四、挂载源码与持久化数据卷
为保证本地编辑实时生效且容器重启后数据不丢失，必须正确配置绑定挂载（bind mount）与命名卷（named volume）策略。
1、在 devcontainer.json 的 “mounts” 字段中添加条目："source": "${localWorkspaceFolder}", "target": "/workspace", "type": "bind"。
2、对数据库等状态服务，使用 “volumes” 字段声明命名卷，例如 "postgres-data:/var/lib/postgresql/data"。
3、确认宿主机路径具有读写权限，尤其在 macOS 上需将项目所在目录加入 Docker Desktop 的 File Sharing 设置列表。
