vs code docker插件日志不显示因默认后台启动；docker-compose context路径相对yaml文件位置；多阶段构建需手动指定target；dev container连接失败多因镜像缺依赖或权限配置错误。
为什么 vscode-docker 插件启动容器后看不到日志？
默认情况下，插件通过 docker run -d 后台启动容器，日志不会自动流到 VS Code 的 OUTPUT 面板。这不是 bug，而是设计使然——它优先保证开发环境不被滚动日志干扰。
实操建议：
- 右键容器 → “View Logs”，打开专用日志流视图（支持实时刷新和搜索）
- 若需启动即看日志，改用命令面板：
Ctrl+Shift+P→ 输入Docker: Run Container→ 选中镜像后勾选Attach to container（等效于加-it参数） - 注意：勾选
Attach后，容器退出时终端会阻塞，适合调试；长期运行服务请保持默认后台模式
docker-compose.yml 中的 build.context 路径为什么总报 “no such file or directory”？
VS Code Docker 插件解析 docker-compose.yml 时，build.context 是相对于该 YAML 文件所在目录计算的，不是工作区根目录，也不是当前打开文件的路径。
常见错误现象：项目结构含多层嵌套，docker-compose.yml 放在 ./deploy/ 下，但 context: ./ 指向的是 ./deploy/，而非项目根目录。
实操建议：
- 统一把
docker-compose.yml放在工作区根目录下（最省心） - 若必须分开放，显式写相对路径：
context: ../或context: ../../src，并确保路径真实存在且有Dockerfile - 插件不会自动 resolve 符号链接，软链目录慎用
context
如何让插件正确识别多阶段构建中的 target 并提供调试支持？
插件默认只构建最终 stage，对 --target 参数支持有限：右键 Dockerfile → Build Image 不会弹出 target 选择，直接忽略 target 字段。
实操建议：
- 手动触发构建时，在命令面板运行
Docker: Build Image With Options，输入类似--target=dev --tag=myapp:dev - 调试阶段镜像（如含
node:18-alpine+nodemon）务必显式指定target，否则可能构建出生产镜像（无调试工具、端口绑定失败） - 插件生成的
.devcontainer.json若引用多阶段镜像，image字段值必须是已构建好的带 tag 镜像，不能写build: { dockerfile: "Dockerfile", target: "dev" }—— devcontainer 当前不支持 inline target 解析
远程容器开发（Dev Container）连接失败，Failed to connect to the remote extension host 怎么查？
这个错误表面是网络问题，实际 80% 出现在镜像缺少必要运行时依赖或权限配置错误，和网络关系不大。
实操建议：
- 先确认镜像中是否安装了
openssh-server和curl（VS Code Remote-SSH 底层依赖）；Alpline 基础镜像常缺curl，导致健康检查失败 - 检查
.devcontainer.json中runArgs是否误加了--read-only或--cap-drop=ALL，这会阻止 VS Code 注入调试代理 - 在容器内手动执行：
ps aux | grep vscode，若无vscode-server进程，说明初始化脚本（postCreateCommand）提前退出或权限拒绝 —— 此时要看Remote-Containers输出通道里的完整日志，不是终端输出
Dockerfile 语法高亮和 lint 是基于本地解析器，不调用 docker build --dry-run，所以有些语义错误（比如 COPY 源路径在构建上下文外）要等真正构建时才暴露。别太信预览红波浪线。
