Eclipse CDT无法在Docker中构建：Docker连接找不到问题排查

问题背景 #

Eclipse CDT已配置识别本地Docker实例（Docker Machine为连接名称），计划使用基于Ubuntu的example/example_build:0.1镜像构建与主机GLIBC版本不同的Hello World程序，但构建时抛出错误：

Unable to find Docker connection:example/example_build:0.1

当前环境信息 #

Eclipse版本 #

Eclipse IDE for C/C++ Developers (includes Incubating components)
Version: 2024-12 (4.34.0)
Build id: 20241128-0757
OS: Linux, v.6.8.0-51-generic, x86_64 / gtk 3.24.41
Java vendor: Ubuntu
Java runtime version: 21.0.5+11-Ubuntu-1ubuntu124.04
Java version: 21.0.5

Docker运行状态 #

example/example_build:0.1镜像对应的容器正在运行：

$ docker ps
CONTAINER ID   IMAGE                       COMMAND   CREATED         STATUS         PORTS     NAMES
80c46a9cf1f9   example/example_build:0.1   "bash"    3 minutes ago   Up 3 minutes             example

需检查/修改的设置与操作 #

• 修正Docker连接与镜像的配置混淆

  1. 打开Eclipse的Window > Preferences > Docker > Connections，确认本地Docker实例的连接名称（非镜像名）已配置且处于Connected状态
  2. 项目构建配置中，Connection字段应选择已配置的Docker连接名称，而非直接填写镜像名example/example_build:0.1——报错核心是混淆了连接名与镜像名的配置项

• 检查项目Docker构建工具链配置

  1. 右键项目选择Properties > C/C++ Build > Tool Chain Editor，确认当前Toolchain为Docker GCC（或对应Docker工具链）
  2. 进入C/C++ Build > Settings > Docker选项卡：
     • Connection下拉框选中本地Docker连接（如默认的local或自定义的Docker Machine名称）
     • Image字段填写正确的镜像名example/example_build:0.1

• 刷新Docker识别缓存

  1. 在Eclipse的Docker视图（Window > Show View > Other > Docker > Docker Containers）中，右键本地连接选择Refresh，确保镜像和容器被正确识别
  2. 重启Eclipse，清除缓存导致的识别异常

• 验证Docker权限与环境变量

  1. 确认运行Eclipse的用户属于docker用户组，执行groups | grep docker检查，若不在则执行sudo usermod -aG docker $USER并重新登录
  2. 检查Eclipse启动时加载的DOCKER_HOST环境变量是否指向本地Docker实例（Linux下默认值为unix:///var/run/docker.sock）

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