VS Code打开Docker时出现docker.host或DOCKER_HOST配置无效错误

报错原因 #

该报错是因为VS Code的Docker插件读取到的Docker连接地址没有带协议头，不符合配置规范。

分步修复步骤 #

• 第一步：先确认你本地的Docker daemon运行状态，确保Docker本身是正常启动的
• 第二步：检查VS Code用户配置里的docker.host字段
  1. 打开VS Code设置，搜索docker.host
  2. 如果该字段有值，检查是否带协议头：
     • 本地Docker默认配置可以填unix:///var/run/docker.sock（Mac/Linux）或者npipe:////./pipe/docker_engine（Windows）
     • 远程Docker需要按要求加对应协议，比如ssh://用户名@远程主机地址或者tcp://远程主机IP:端口
  3. 如果没有远程连接需求，直接把docker.host字段清空即可，插件会自动读取本地默认的Docker连接地址
• 第三步：检查系统环境变量DOCKER_HOST
  1. 如果你配置过这个环境变量，同样检查值是否带协议头
  2. 不需要的话直接删除该环境变量，重启终端/VS Code生效

验证方法 #

修复完成后重启VS Code，打开Docker插件面板，就能正常加载容器、镜像列表了。

注意：如果是连接远程Docker，要确保远程主机的Docker daemon已经开放了对应端口或者SSH登录权限。

内容的提问来源于stack exchange，提问作者usman shaikhnag