VS Code任务报“command not found: docker”主因是任务使用非登录shell，未继承系统PATH；需在tasks.json中显式指定docker完整路径或配置shell为登录模式。
VS Code 本身不执行 docker build，它只是调用你本地已安装的 Docker CLI。所谓“自动化”，本质是把构建命令封装进任务配置，避免每次手动敲命令——但前提是 docker 命令必须可用、Dockerfile 路径必须正确、上下文路径不能错。
为什么 tasks.json 里写 docker build 却报 command not found
常见错误现象：VS Code 终端能运行 docker --version，但通过 Terminal > Run Task 执行构建任务时提示 command not found: docker。
- VS Code 的任务（Task）默认使用非登录 shell 启动，PATH 可能没继承你 shell 配置里的
/usr/local/bin或~/.docker/bin - macOS 上如果用 Homebrew 安装 Docker Desktop，CLI 路径通常是
/opt/homebrew/bin/docker，但 VS Code GUI 启动时未必加载该 PATH - Windows 用户若用 WSL2 后端，任务默认跑在 Windows 子系统外，
docker命令只在 WSL2 内可用，需显式指定"shell": {"executable": "wsl", "args": ["-e", "bash"]}
解决办法：在 .vscode/tasks.json 中显式写全路径，比如 "command": "/usr/local/bin/docker"（macOS）或 "command": "C:\Program Files\Docker\Docker\resources\bin\docker.exe"（Windows）。
docker build 任务中如何正确设置上下文路径和标签
构建失败常因上下文路径（--context）和 Dockerfile 位置不匹配。VS Code 任务不会自动推断上下文，全靠你写死。
- 如果
Dockerfile在项目根目录，上下文必须设为"."；若在./docker/app/Dockerfile，则上下文应为"./docker/app"，且--file参数要指向./docker/app/Dockerfile - 镜像标签建议用变量动态生成：
"args": ["build", "-t", "${input:imgTag}", "-f", "./Dockerfile", "."]，再在inputs里定义imgTag类型为promptString - 多阶段构建需加
--target，例如"args": ["build", "--target", "builder", "-t", "myapp:dev", "."]
别漏掉 "isBackground": true 和 "problemMatcher"，否则 VS Code 不会捕获构建日志里的 ERROR 行，出错也不报红。
构建缓存失效却没察觉？docker build 任务默认不显示进度细节
VS Code 默认用 --progress=auto，终端里只显示简略状态条。一旦某层缓存失效（比如 COPY package.json 后文件变了），你可能根本没意识到构建实际从头跑了。
- 调试缓存问题时，把
"args"改成["build", "--progress=plain", "-t", "myapp:debug", "."]，能看到每行 RUN 指令是否 HIT 缓存 - 想强制跳过缓存，加
--no-cache，但别长期开着——CI/CD 流水线里用它会显著拖慢构建 - 注意
--progress=plain输出含 ANSI 控制符，在 VS Code 任务面板里可能显示乱码；真要分析，直接切到终端手动跑更可靠
真正容易被忽略的是：VS Code 任务不支持 buildx 的高级特性（如跨平台构建、远程构建器集群）。需要这些能力，还是得回到终端敲 docker buildx build。
