真正可用、稳定、符合生产运维逻辑的只有2个核心扩展：docker extension（ms-azuretools.vscode-docker）和Remote-Containers；其余多为功能重叠、权限失控或已废弃。
VS Code 本身不提供 Docker 容器自动化管理能力，所谓“6个扩展”是误导性归纳——真正可用、稳定、符合生产运维逻辑的只有 2 个核心扩展，其余多为功能重叠、权限失控或已废弃。
docker extension（ms-azuretools.vscode-docker）为什么必须装
这是微软官方维护的 vscode-docker 扩展，唯一能正确解析 Dockerfile、docker-compose.yml 并绑定到命令面板和资源管理器的入口。它不是“锦上添花”，而是所有后续操作的基础。
- 不装它，
Ctrl+Shift+P里搜不到Docker: Build Image或Docker: Run Container - 它会自动识别项目根目录下的
docker-compose.yml，但只支持 v2/v3 语法，遇到version: "3.9"且含deploy:字段时可能静默忽略服务 - 右键点击
Dockerfile的构建选项默认使用当前文件所在目录为context，如果COPY引用了上层路径（如COPY ../dist ./app），构建必然失败——得手动改docker build -f命令里的--context
devcontainer.json 自动重建容器时常见的挂载失效问题
用 Remote-Containers: Reopen in Container 启动后，devcontainer.json 里声明的 mounts 或 runArgs 可能被忽略，尤其在 Windows 主机 + WSL2 后端场景下。
- Windows 路径写成
"source": "C:\Projects\myapp"会触发invalid mount config错误，必须用正斜杠："source": "/c/Projects/myapp" -
postCreateCommand在容器首次创建时运行，但若你修改了devcontainer.json后点 “Rebuild and Reopen”，该命令不会重跑——得删掉.devcontainer/data目录再试 - 使用
image字段而非dockerFile时，build配置完全无效，args和cacheFrom全部丢弃
docker-compose up --build 不触发、或反复重建镜像的三个原因
VS Code 集成终端里执行 docker-compose up --build 看似正常，但实际没 rebuild，或者每次都在 pull 基础镜像——根本不是扩展的问题，而是 compose 的缓存机制和 VS Code 终端工作目录错位导致。
- 终端打开位置不在
docker-compose.yml所在目录，docker-compose会向上递归找配置，找到旧版本的yml文件 -
build.context设为.，但Dockerfile里有COPY package.json .，而你刚删过node_modules，Docker 缓存仍认为这一层没变，跳过安装依赖 - 用
docker-compose -f docker-compose.dev.yml up --build，但扩展默认只监听docker-compose.yml，资源管理器里右键“Up”按钮压根不认这个文件名
remote-containers 扩展无法连接已存在容器的典型报错
当你想把一个已在运行的容器（比如用 docker run -d -p 3000:3000 myapp 启的）接入 VS Code 开发环境，Remote-Containers: Attach to Running Container 列表为空，或选中后报 Could not establish a connection。
- 容器启动时没加
-v /var/run/docker.sock:/var/run/docker.sock，remote-containers就没法调用 Docker API 查进程状态 - 容器内没装
tar命令（Alpine 镜像常见），VS Code 无法同步文件，直接中断连接 - 用了
USER node启动容器，但remote-containers默认以 root 用户注入 server，权限冲突导致/root/.vscode-server写入失败
真正要实现微服务本地调试闭环，关键不在装多少扩展，而在搞清 docker-compose.yml 的 service 依赖顺序、devcontainer.json 的生命周期钩子执行时机、以及 VS Code 底层调用的是哪个 Docker socket。插件只是胶水，胶水粘不住设计裂缝。
