VSCode Docker插件侧边栏为空，是因为插件仅显示docker ps可见的运行中容器，且依赖本地docker CLI可用；需确保daemon运行、用户权限正确（Linux加docker组、macOS从终端启动code .）、环境变量继承到位。
很多开发者初次使用VSCode的Docker插件时，都会遇到一个困惑：为什么侧边栏空空如也，或者操作没反应？其实，这里有个关键认知需要先建立：VSCode本身并不运行容器，它只是一个“传话筒”，背后调用的始终是你本地的docker命令行工具。所以，插件没反应、看不到容器、构建失败，十有八九不是插件本身坏了，而是它背后的docker CLI不可用，或者权限、环境变量没有正确继承到VSCode的进程里。
为什么 Docker 插件侧边栏是空的？
首先得明白，插件侧边栏里显示的，并不是你所有的镜像或停止的容器，它只展示docker ps命令能看到的、正在运行的容器。如果这里一片空白，排查思路就很清晰了。
- 第一步，先打开终端，执行
docker ps。如果这条命令有正常输出，说明Docker守护进程（daemon）是好的；如果它报错“Cannot connect to the Docker daemon”，那插件侧边栏必然是空的，问题出在Docker服务本身。 - 对于macOS用户，这里有个经典陷阱：如果你是从Dock或启动台点击VSCode图标打开的，那么VSCode进程很可能丢失了
$PATH和DOCKER_HOST等环境变量。正确的打开方式是：先打开终端，进入项目目录，然后执行code .命令来启动VSCode。 - Linux用户则需要检查用户组权限。在终端里运行
groups命令，看看输出里是否包含docker这个组。如果没有，你需要执行sudo usermod -aG docker $USER将当前用户加入docker组，然后完全退出系统重新登录（或者重启），这个改动才会生效。 - Windows用户相对简单，主要确认Docker Desktop已经启动，并且最好在设置里勾选上
Start Docker Desktop when you log in（登录时自动启动）。
右键容器 → Exec in Container 没反应或报错？
点击容器右键菜单的“Exec in Container”没反应，或者终端一闪而过？这通常不是插件卡住了，而是它默认使用的shell路径在目标容器里根本不存在。
- 插件默认会尝试使用
/bin/bash来进入容器。但很多轻量级镜像，比如alpine、scratch或者各种slim版本，为了精简体积，压根就没装bash。这时候，手动输入/bin/sh往往就能成功——因为sh的存在概率要高得多。 - 如果不确定容器里有什么可用的shell，可以先用终端做个侦查：
docker exec -it，看看列表里有什么。ls /bin/ - 如果你厌倦了每次都手动改，可以在VSCode的
settings.json里加一行配置，一劳永逸："docker.explorer.execCommand": "/bin/sh"，这样右键菜单就会默认使用sh了。 - 还有一种情况：如果容器的主进程已经退出（比如你用
docker run -d alpine sleep 10启动了一个只休眠10秒的容器），那么Exec in Container即使连上了，也会因为容器生命周期结束而瞬间断开。这不是插件的问题，而是容器本身的状态导致的。
右键 Dockerfile → Build Image 失败？
在VSCode里右键Dockerfile选择构建镜像，结果失败了？先别急着怪插件，它只是忠实地执行了一条命令：docker build -f Dockerfile .。这里的“.”，也就是构建上下文（context），被设定为当前Dockerfile所在的目录，而不是整个项目的根目录。
- 举个例子，如果你的项目结构是
./src/Dockerfile，而Dockerfile里有一句COPY package.json .，那么构建就会失败。因为插件会在./src目录下寻找package.json，但这个文件实际上在上层目录里。 - 解决方法有两个：一是把
Dockerfile文件移到项目根目录；二是放弃在插件里右键构建，改用终端手动执行，并指定正确的上下文路径：docker build -f src/Dockerfile .（注意最后的“.”代表当前目录，即项目根目录）。 - 另外，插件本身不会主动识别
.dockerignore文件，但这个文件在通过CLI构建时是会被读取的。所以，一个黄金法则是：确保你在终端里用docker build命令能成功构建，再去指望插件GUI。 - 如果构建失败，详细的错误日志在哪里？它们藏在VSCode的
Output面板里。点击面板，切换到Docker标签，这里面的信息比弹窗提示要详细得多，是排查问题的关键。
Dev Containers 一键进容器却卡在 “Building image”？
使用Dev Containers功能，本想一键进入开发容器，却卡在“Building image”阶段半天不动。这通常不是网络下载镜像慢，而是配置文件出了岔子，或者路径权限不对。
- 首先检查
devcontainer.json配置文件。单独写一行"dockerFile": "Dockerfile"是无效的，它必须被包裹在"build": {}对象里。正确的写法是："build": { "dockerfile": "Dockerfile" }。 - 在Linux或macOS系统上，一个常见的错误是
EACCES权限错误。这是因为宿主机挂载的代码目录，到了容器内部，默认的非root用户（比如node用户）没有写入权限。一个临时的解决方案是在devcontainer.json中添加："runArgs": ["--user", "root"]，让容器以root身份运行。 - 更稳妥的做法是利用
"postCreateCommand"配置项，在容器创建后自动修正权限。例如："postCreateCommand": "chown -R node:node /workspace"。 - 还有开发者反映，修改代码后容器内的服务没有热更新。这其实不是插件的问题，而是你的Docker镜像里没有配置热重载逻辑（比如Node.js项目的nodemon，Python的watchmedo）。容器运行时，加载的是构建那一刻的静态文件，自然无法感知宿主机文件的变化。
说到底，真正卡住人的地方，往往不是某个功能不会用，而是VSCode这个GUI进程压根就没拿到docker命令的执行环境——尤其是在macOS和Linux下，如果你从桌面图标启动VSCode，PATH环境变量、Docker socket的路径、用户组权限这些关键信息可能全部丢失了。验证方法非常简单：打开VSCode内置的终端（快捷键Ctrl+`），输入docker version。如果这条命令能正常返回版本信息，那么插件基本上就能正常工作了；如果报错，那么所有问题的根源，就在这里。
