Ubuntu系统下VSCode打开Docker容器持续报错如何排查

以下操作按顺序执行，每步完成后重试启动容器，恢复正常即可停止后续操作：

• 前置校验：先打开本地系统终端执行docker ps，如果命令返回权限错误/无法连接docker引擎，先启动Docker Desktop（Windows/macOS），或者把当前用户加入docker用户组（Linux执行sudo usermod -aG docker $USER后注销重登），确保docker命令可正常运行。
• 清理残留缓存：重建容器无效基本是VSCode Server的残留容器、卷缓存损坏导致，终端依次执行以下命令清理：

  # 停止所有VSCode关联的运行中容器
  docker stop $(docker ps -q --filter "label=vsch.quality") 2>/dev/null
  # 删除残留的VSCode关联容器
  docker rm $(docker ps -a -q --filter "label=vsch.quality") 2>/dev/null
  # 清理关联的无用存储卷
  docker volume prune -f --filter "label=vsch.quality"
  

  执行完成后完全退出VSCode再重新打开。
• 检查Dockerfile依赖兼容性：如果你用的是Alpine、distroless这类极简基础镜像，VSCode Server会因为缺少bash、C++运行库启动失败。可以临时把Dockerfile基础镜像替换为ubuntu:22.04测试，如果能正常启动，就给原基础镜像补全依赖，Alpine镜像补依赖参考：

  RUN apk add --no-cache bash libstdc++ curl ca-certificates
  

• 核对挂载权限：Windows/macOS用户打开Docker Desktop设置，找到File Sharing选项，把你存放本地代码仓库的磁盘目录加入共享列表，保存后重启Docker；Linux用户检查代码目录权限不要设为777或者仅root可读，避免容器挂载时权限异常。
• 修复扩展异常：打开VSCode扩展面板，找到Docker、Dev Containers两个扩展，卸载后重启VSCode，安装正式稳定版（不要选Pre-release预发布版本），避免新版本兼容bug。

操作提示：不要直接点击Dockerfile右上角的单文件容器启动按钮，先手动在终端执行docker build -t dev-test .确认Dockerfile本身构建无报错，再按Ctrl+Shift+P调出命令面板，选择Dev Containers: Reopen in Container启动，触发异常的概率更低。

内容的提问来源于stack exchange，提问作者Alec Phong