Cabal Build异常：无法检测代码文件变更问题排查

核心原因 #

你遇到的问题主要是Nix的缓存机制和Cabal的构建缓存共同作用导致的：

• Nix在启动nix-shell时会对项目源码进行哈希快照，用于缓存构建环境，即使修改了文件，Nix可能仍在使用旧的快照。
• Cabal的dist-newstyle缓存目录会保留之前的构建产物，当它认为文件没有变更时（哪怕实际变更了），会直接复用缓存结果。

解决步骤 #

1. 清理Cabal构建缓存

直接清除Cabal的本地构建产物，强制重新编译：

cabal clean
# 或者手动删除缓存目录
rm -rf dist-newstyle

2. 强制Nix重新识别源码变更

Nix的shell环境可能缓存了源码的哈希，需要触发它重新计算：

• 先修改Nix配置文件的时间戳（让Nix认为环境配置变更了），再重新进入shell：

touch shell.nix default.nix  # 如果项目有这些文件
exit
nix-shell --pure  # --pure参数确保隔离宿主环境干扰

• 或者在进入shell时直接添加--rebuild参数（部分Nix版本支持）：

nix-shell --rebuild

3. 强制Cabal重新检测文件

如果上述步骤无效，在nix-shell内执行构建时添加强制参数：

cabal build --force-reinstalls --disable-documentation

--force-reinstalls会强制重新编译所有依赖和目标文件，--disable-documentation可以加快构建速度。

4. 修复MacOS-Docker文件同步问题

如果你是从MacOS主机挂载目录到Docker容器，APFS和Linux的文件修改时间（mtime）同步可能有问题。可以手动更新所有Haskell文件的mtime，触发Cabal的检测：

find . -type f -name "*.hs" -exec touch {} \;

补充说明 #

cabal repl能识别变更的原因是：它默认采用动态加载模式，会直接读取当前文件内容，而不会完全依赖Cabal的构建缓存；但cabal build则严格依赖文件的依赖追踪和缓存状态，所以需要手动清除缓存或触发重新检测。

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