Cabal构建Hackage的qhull时gcc找不到qhull_ra.h头文件求助

问题详情 #

构建qhull包时触发gcc编译错误：

fatal error: qhull_ra.h: No such file or directory
        2 | #include "qhull_ra.h"

`gcc' failed in phase `C Compiler'. (Exit code: 1)

qhull_ra.h位于项目的Cdir目录下，当前Cabal配置的相关片段如下：

include-dirs:        ./Cdir
  C-sources:           ./Cdir/libqhull_r.c
                     , ./Cdir/geom_r.c
                     , ...

该错误偶发无规律，已获作者授权准备上传包，需修复编译问题使cabal install可正常执行。

原因分析 #

1. 增量构建缓存遗漏：Cabal默认的增量构建逻辑不会自动追踪未声明的头文件依赖，当头文件未被列入包的源文件清单时，Cabal可能在某些场景下（比如缓存未失效）不传递正确的包含目录给gcc，导致找不到头文件。
2. 相对路径解析歧义：./Cdir这种相对路径在不同构建上下文（本地构建、Hackage远程构建）中可能被Cabal解析为不同路径，导致gcc无法定位到包含目录。

修复方案 #

1. 显式声明头文件依赖 #

在.cabal文件的对应library或executable块中，补充头文件的声明，确保Cabal能追踪这些文件并正确传递包含目录：

include-dirs:        Cdir  # 移除./前缀，避免路径解析歧义
extra-source-files:  Cdir/qhull_ra.h, Cdir/*.h  # 列出所有头文件，或用通配符批量匹配

• include-dirs：明确告知gcc要搜索的头文件目录
• extra-source-files：将头文件纳入包的源文件集合，让Cabal在构建时同步这些文件到构建目录，同时触发增量构建的依赖检查

2. 清理构建缓存强制全量构建 #

偶发问题大概率和增量缓存有关，执行以下命令清理缓存后重新构建：

cabal clean
cabal install --force-reinstalls

3. 升级Cabal到稳定版 #

旧版本Cabal对include-dirs和extra-source-files的处理存在已知bug，升级到最新稳定版可避免此类问题：

cabal update
cabal install cabal-install

4. 验证路径与文件完整性 #

• 确认Cdir目录与.cabal文件处于同一层级
• 检查qhull_ra.h文件名的大小写（Linux/macOS下路径区分大小写）
• 确保所有需要的头文件都存在于Cdir目录中

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