vscode 依赖本地 docker cli 执行容器操作，必须先安装并启动 docker 引擎，验证 docker --version 可用；再安装官方 docker 扩展和配置 dev containers 实现容器化开发。
vscode 本身不直接创建或运行 docker 容器，它通过扩展与 docker cli 协同工作——真正执行容器操作的是你本地已安装的 docker 命令行工具。没装 docker desktop（macos/windows）或 docker-ce（linux），vscode 扩展再强也启动不了容器。
必须先确认 docker 命令可用
这是所有后续操作的前提，也是新手最容易卡住的第一步。
- 终端中运行
docker --version，有输出说明 CLI 已就绪；若报command not found或Cannot connect to the Docker daemon，需先安装并启动 Docker 引擎 - Linux 用户注意：还需把当前用户加入
docker用户组（sudo usermod -aG docker $USER），否则会因权限不足被拒绝 - VSCode 内置终端（
Ctrl+`）默认不会自动加载 shell 配置，如果docker在 zsh/bash 中可用但在 VSCode 终端里不可用，检查"terminal.integrated.defaultProfile.linux"等设置是否指向了正确 shell
安装 Docker 扩展并连接到本地引擎
VSCode 的官方 Docker 扩展（由 Microsoft 发布）提供侧边栏容器/镜像管理、Dockerfile 高亮、命令快捷入口等功能，但它只是“遥控器”，不是“发动机”。
- 在扩展市场搜索并安装
Docker（发布者：Microsoft） - 安装后重启 VSCode，左侧活动栏会出现鲸鱼图标；若图标灰显或提示 “No Docker daemon detected”，说明扩展找不到
docker可执行文件或守护进程未响应 - 扩展默认使用
DOCKER_HOST环境变量或 Unix socket（/var/run/docker.sock）连接本地引擎，不支持直接配置远程 Docker 主机（如云服务器上的 Docker）——如需远程，得靠 SSH 隧道或docker context配合本地 CLI
用 Dev Containers 实现一键容器化开发环境
这才是 VSCode 在容器化开发中最实用的功能：把整个开发环境（含依赖、工具链、端口映射）定义在代码仓库中，打开文件夹即自动构建并进入容器内工作。
Destoon B2B网站管理系统是一套完善的B2B(电子商务)行业门户解决方案。系统基于PHP+MySQL开发，采用B/S架构，模板与程序分离，源码开放。模型化的开发思路，可扩展或删除任何功能；创新的缓存技术与数据库设计，可负载千万级别数据容量及访问。 系统特性1、跨平台。支持Linux/Unix/Windows服务器，支持Apache/IIS/Zeus等2、跨浏览器。基于最新Web标准构建，在
- 前提：项目根目录存在
.devcontainer/devcontainer.json（可手动创建，也可用命令面板Dev Containers: Add Development Container Configuration Files...生成） -
devcontainer.json中关键字段："image"指定基础镜像（如mcr.microsoft.com/vscode/devcontainers/python:3.11），"forwardPorts"自动转发容器端口到宿主机，"customizations.vscode.extensions"声明容器内要预装的 VSCode 扩展 - 首次打开时，VSCode 会调用
docker build构建镜像（如有Dockerfile），再用docker run启动容器，并挂载当前目录为工作区——你编辑的代码实时存在于容器内 - 注意：
devcontainer.json中的"workspaceFolder"默认是/workspace，但某些基础镜像可能没创建该路径，导致挂载失败；可在postCreateCommand中加mkdir -p /workspace避免
{
"image": "mcr.microsoft.com/vscode/devcontainers/python:3.11",
"forwardPorts": [8000],
"customizations": {
"vscode": {
"extensions": ["ms-python.python"]
}
},
"postCreateCommand": "pip install -r requirements.txt"
}
日常调试：容器内进程和端口别被“黑盒”掉
Dev Container 启动后，VSCode 的终端默认进入容器内部，但调试器、HTTP 服务、日志输出等容易因路径/网络/权限错位而失效。
- 调试 Python/Node.js 时，确保
launch.json中的"cwd"指向容器内路径（如/workspace），而非宿主机路径 - Web 服务监听
localhost:8000在容器内无法被宿主机访问——必须监听0.0.0.0:8000，且devcontainer.json中已声明"forwardPorts": [8000] - 容器内生成的日志文件（如
app.log）写在容器文件系统中，关闭容器即丢失；如需持久化，用"mounts"字段挂载宿主机目录，例如"mounts": ["source=/tmp/logs,target=/workspace/logs,type=bind,consistency=cached"]
Dev Containers 不是魔法，它把 docker run 的参数封装进了 JSON，但底层仍是标准 Docker 行为。一旦遇到网络不通、挂载失败或构建卡住，第一反应不应该是查 VSCode 文档，而是打开终端执行 docker ps、docker logs <container-id></container-id>、docker inspect <container-id></container-id> ——这些原始命令永远比图形界面更诚实。
