vscode docker插件侧边栏为空，是因为插件仅显示docker ps可见的运行中容器，且依赖本地docker cli可用；需确保daemon运行、用户权限正确（linux加docker组、macos从终端启动code .）、环境变量继承到位。
docker 命令；插件没反应、看不到容器、构建失败，90% 是因为 docker CLI 不可用或权限/环境变量没继承到位。
为什么 Docker 插件侧边栏是空的？
插件只显示 docker ps 能看到的正在运行的容器，不是所有容器都列出来。
- 先在终端执行
docker ps，有输出才说明 daemon 正常；如果报Cannot connect to the Docker daemon，插件必然空白 - macOS 用户：必须从终端启动 VSCode（
code .），点 Dock 图标打开会丢失$PATH和DOCKER_HOST - Linux 用户：检查
groups输出是否含docker；没有就运行sudo usermod -aG docker $USER，然后完全退出重登 - Windows 用户：确认 Docker Desktop 已启动，且勾选了
Start Docker Desktop when you log in
右键容器 → Exec in Container 没反应或报错？
插件默认尝试 /bin/bash，但很多镜像（比如 alpine、scratch 或 slim 镜像）根本没装 bash。
- 手动输入
/bin/sh—— 它比bash存在概率高得多 - 不确定容器里有什么 shell？先终端执行：
docker exec -it <container-id> ls /bin/</container-id> - 想让右键菜单默认走
/bin/sh，在 VSCodesettings.json加一行："docker.explorer.execCommand": "/bin/sh" - 如果容器主进程已退出（例如用
sleep 10启动），Exec in Container会瞬间断开，这不是插件问题，是容器生命周期结束了
右键 Dockerfile → Build Image 失败？
插件调的是 docker build -f Dockerfile .，上下文路径（.）就是当前文件所在目录，不是项目根目录。
- 如果你的
Dockerfile在./src/Dockerfile，而它里面有COPY package.json .，构建就会失败——因为package.json在上层目录，不在./src下 - 解决方法一：把
Dockerfile放到项目根目录；解决方法二：改用终端手动构建，指定上下文：docker build -f src/Dockerfile . - 插件不会自动识别
.dockerignore，但 CLI 会读；确保你在终端里也能成功构建，再指望插件 - 构建日志藏在 VSCode 的
Output面板 → 切换到Docker标签，比弹窗提示详细得多
Dev Containers 一键进容器却卡在 “Building image”？
这通常不是网络或镜像问题，而是 devcontainer.json 配置不完整，或挂载路径权限不对。
-
"dockerFile": "Dockerfile"单独写没用，必须包在"build": {}里："build": { "dockerfile": "Dockerfile" } - Linux/macOS 下常见
EACCES错误：宿主机挂载的代码目录，容器内非 root 用户（如node）没写权限；临时解法是在devcontainer.json加："runArgs": ["--user", "root"] - 更稳妥的做法是用
"postCreateCommand"自动修正权限，例如："postCreateCommand": "chown -R node:node /workspace" - 修改代码后服务不热更新？不是插件问题，是镜像里没配热重载逻辑（比如 nodemon、watchmedo），容器只运行构建那一刻的静态产物
docker 命令的执行环境——特别是 macOS 和 Linux 下从桌面图标启动时，PATH、socket 路径、用户组权限全丢了。验证方式很简单：打开 VSCode 内置终端（Ctrl+`），敲 docker version，能出结果，插件才能动。
