如何查找导致Cargo/maturin触发不必要重新编译的变更文件？

1. 定位Cargo侧重编译触发文件 #

Cargo本身内置了指纹诊断日志，不需要额外工具，执行命令前加环境变量即可输出重编译的具体原因：

CARGO_LOG=cargo::core::compiler::fingerprint=info cargo test -p mypkg --release

执行后输出的日志中会明确标注哪个依赖的指纹过期、是哪个文件的修改/配置变更触发了重编译，比-vv参数的输出更精准。
如果排查后确认cargo单独执行两次不会重编译，再往下排查maturin的调用差异。

2. 排查maturin调用的Cargo参数差异 #

maturin底层完全依赖cargo执行编译，重复编译90%以上的概率是它调用cargo的参数和你手动执行的参数不一致：

• 先升级到最新版maturin，旧版本确实缺少日志输出能力，新版本支持-v参数可以打印完整的cargo调用命令：

  maturin develop --release -v
  

• 把打印出的cargo命令和你手动执行的cargo test命令做对比，重点核对以下项：
  • 是否使用了相同的--target目标三元组
  • 是否开启了不同的feature开关
  • 是否指定了不同的编译profile、优化等级、LTO等配置
  • 环境变量CARGO_TARGET_DIR是否一致
• 检查项目根目录pyproject.toml中的[tool.maturin]配置段，是否配置了隐式的cargo-extra-args、features等参数，这些参数会在调用cargo时自动注入，你手动执行命令时如果没加就会导致缓存不兼容。

3. 排查文件时间异常 #

Cargo依赖文件修改时间（mtime）判断是否需要重编译，如果项目中有文件的修改时间是未来时间，会持续触发重编译，可以用以下命令排查：

find . -type f -newermt "now"

如果有输出结果，用touch命令重置对应文件的修改时间即可。

• 手动执行cargo test时默认会开启test feature，而maturin编译时不会自动注入该feature，导致依赖的feature组合变更，触发全量重编译。可以在手动跑test时和maturin使用相同的feature参数，或者在pyproject.toml中配置maturin同步使用test feature解决。
• 两个命令使用的Rust工具链版本不一致，比如手动执行用的是stable工具链，maturin调用的是nightly工具链，可以同时执行cargo --version和maturin -v核对输出的工具链版本。

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