Eclipse CDT 编译正常但无法识别Docker容器内arm-none-eabi交叉编译头文件

问题根因 #

编译环节直接调用容器内的交叉编译工具链，工具链会自动检索容器内的标准头文件路径，因此编译正常。但Eclipse的代码索引默认仅扫描宿主机本地文件系统的路径，未配置映射规则的情况下无法读取容器内部的文件，因此会报头文件找不到的警告、无法跳转。
不需要对容器做特殊改造，两种可选解决方案如下：

方案1：配置CDT Docker工具链路径映射（无需挂载，推荐） #

如果你使用的是官方CDT Docker Toolchain插件，直接在项目属性中配置路径映射即可：

• 右键项目选择Properties → 找到C/C++ General → Paths and Symbols
• 切换到Includes标签页，选择对应的语言（GNU C/GNU C++）
• 添加容器内的头文件路径，arm-none-eabi的标准头文件通常在以下路径：
  • /usr/arm-none-eabi/include
  • /usr/lib/gcc/arm-none-eabi/[你的gcc版本号]/include
• 切换到Docker Container标签页（部分版本在Path Mapping分类下），将上述容器路径和当前使用的容器做绑定，CDT索引器会自动从容器中拉取头文件内容做解析，不需要挂载到宿主机。

提示：可进入运行中的容器执行arm-none-eabi-gcc -print-search-dirs命令，输出的install行对应的路径就是gcc内置头文件的实际路径。

方案2：挂载容器头文件路径到宿主机 #

如果不需要频繁更换容器版本，可以选择将头文件目录挂载到宿主机本地，操作更简单：

• 启动容器时添加挂载参数，示例命令：

  docker run -v /本地/arm-eabi-include:/usr/arm-none-eabi/include -v /本地/arm-eabi-gcc-include:/usr/lib/gcc/arm-none-eabi/[你的gcc版本号]/include [其他启动参数] 你的镜像名
  

• 回到Eclipse项目的Paths and Symbols → Includes中，添加上述两个宿主机本地路径到索引扫描列表即可。

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