rustc 崩溃报 ICE 时如何用 RUST_BACKTRACE 和 ICE 文件定位与复现问题【免费下载链接】rustEmpowering everyone to build reliable and efficient software.项目地址: https://gitcode.com/GitHub_Trending/ru/rust用 rustc 编译程序时偶尔会遇到编译器自身 panicstderr 打出internal compiler errorICEInternal Compiler Error而不是普通的编译错误。这时要做两件事拿到编译器内部的调用栈和 query stack 来定位 panic 发生的位置并整理出一套可以反复复现的最小组合。rustc 开发者指南的 compiler-debugging 章节与 fuzzing 指南给出了这条路径上实际使用的两个工具RUST_BACKTRACE环境变量以及 rustc 自动写出的 ICE 文件rustc-ice-*.txt。ICE 发生后先看哪两处默认信息rustc 发生 ICE 时stderr 会输出以下为文档示例输出具体 panic 位置取决于你的输入error: internal compiler error: unexpected panic note: the compiler unexpectedly panicked. this is a bug. note: run with RUST_BACKTRACE1 for a backtrace thread rustc panicked at ...其中还包含一段query stack during panic:块列出 panic 时正在执行的编译器 query。如果 query 调用链很深stderr 只显示前几帧并附带提示... and N other queries... use env RUST_BACKTRACE1 to see the full query stack提示文案见 query stack 输出实现。与此同时nightly 构建的 rustc 会把 ICE 内容写进当前工作目录文件名是rustc-ice-timestamp-pid.txt。文件里包含写入逻辑见 panic hookthread name panicked at 位置以及 panic 消息一段强制捕获的stack backtrace:完整的query stackquery stack during panic:…end of query stack写入实现见 print_query_stack。这一点很关键即使 stderr 里的 query stack 被截断ICE 文件中是完整版。定位的第一步就是在运行 rustc 的目录下找到这个文件把其中的 panic 位置、完整 backtrace 和完整 query stack 对照 stderr 一起看。用 RUST_BACKTRACE 拿完整调用栈复现 ICE 时显式设置环境变量RUST_BACKTRACE1 rustc 你的文件.rsRUST_BACKTRACE1和普通 Rust 程序一样在 stderr 打印 panic 调用栈。文档中的示例输出文档示例形如stack backtrace: 0: std::sys::imp::backtrace::tracing::imp::unwind_backtrace 1: std::sys_common::backtrace::_print ... 32: rustc_typeck::check_crate 33: std::thread::local::LocalKeyT::with 35: rustc::ty::context::TyCtxt::create_and_enter 36: rustc_driver::driver::compile_input 37: rustc_driver::run_compilerRUST_BACKTRACEfull打印更详细的 verbose backtrace文档示例输出中的提示语即run with RUST_BACKTRACEfull for a verbose backtrace。不设置RUST_BACKTRACE时的默认行为见 install_ice_hookdev 通道默认使用短Short样式 backtrace其他发布通道默认 Full。想要确定性的输出就显式设置该变量。backtrace 没有行号时默认配置构建的 rustc 没有行号信息栈帧只有模块路径。如果需要行号要从源码构建编译器并在bootstrap.toml中设置配置说明rust.debug true然后重新构建编译器——文档明确说明修改任何配置项后都必须 rebuild。之后 backtrace 会带上at 文件路径:行号形式的信息。若还需要在 GDB 中调试符号文档建议同时设置rust.debuginfo-level 2但会显著增大磁盘占用文档注释提到 35GB 以上和编译时间。平台限制文档明确说明MinGW 上 backtrace 不工作。如果 backtrace 里全是unknown换用 Linux、macOS或 Windows 上的 MSVC 环境。读取并核对 ICE 文件文件名为rustc-ice-timestamp-pid.txt默认写入当前工作目录。控制写入行为的环境变量实现见 ice_path_with_config设置效果不设置若给出了-Zmetrics-dir则写入该目录否则写入当前工作目录RUSTC_ICE0不写 ICE 文件文档Suppressing the ICE file一节RUSTC_ICE目录把 ICE 文件写到指定目录此时-Zmetrics-dir被忽略源码中会打印相应 warning一个容易踩的限制源码中对is_nightly_build()做了检查即ICE 文件只在 nightly 构建上写入stable 版本不会生成这个文件只能依赖RUST_BACKTRACE的 stderr 输出。核对方式ICE 发生后在运行 rustc 的目录执行ls rustc-ice-*.txt确认文件已生成并检查其中包含stack backtrace:与query stack during panic:/end of query stack段落说明强制捕获的栈与完整 query stack 都已落盘。复现与缩小范围按 fuzzing 指南 的流程确认最新 nightly 上仍存在。用最新 nightly rustc 重跑同一输入很多 ICE 已被修复报告前文档要求先确认 bug 仍然存在。保留一个最小的、可独立运行的复现用例。复现命令模式固定为RUST_BACKTRACE1 rustc 最小复现文件.rs重跑直到得到与首次一致的 ICE 报错与 query stack。最小化时保留原始错误。指南提醒删减输入时不要引入语法、类型检查或 borrow 检查错误来分心。文档推荐的工具中treereduce-rust与picireny是语法感知的halfempty不是语法感知但质量较高。用 query stack 判断是否同一个问题。指南指出同一行报错但query stack不同的两个 ICE 通常是不同的 bug文档给出了两条错误消息相似但 query stack 分别为[fn_abi_of_instance]与[check_mod_attrs]的对照示例。搜索已有 issue 时应同时比对错误消息和 query stack。可选分支把报错位置也变成栈如果目标不是 ICE而是想知道某个普通编译错误是在编译器哪段代码里产生的同一章节提供了-Z treat-err-as-bug[n]让编译器在第n个错误省略n时为第 1 个处 panic从而拿到错误发生点的 backtrace。按 unstable-book 的说明使用该 flag 时编译器会为自己自动设置RUST_BACKTRACE1无需手动再设。文档示例示例输出RUST_BACKTRACE1 rustc stage1 error.rs -Z treat-err-as-bug其中error.rs为fn main() { 1 (); }编译器先打印 E0277 错误随后以internal compiler error: unexpected panicpanic栈指向错误上报路径如rustc::traits::error_reporting::...。相关的辅助-Zflag均为 nightly 上的不稳定 flag可用-Z help查看全部列表-Z verbose-internals打印更多可能用于调试的内部信息-Z track-diagnostics为每条诊断打印其创建位置如-Ztrack-diagnostics: created at compiler/rustc_trait_selection/src/traits/error_reporting/mod.rs:638:39。它不需要 debug 构建也不用读完整个大栈与-Z treat-err-as-bug的区别是它会打印所有错误的创建位置。边界与后续动作需要记住的限制ICE 文件仅在 nightly 构建上生成stable 下只有RUST_BACKTRACE的 stderr 信息可用MinGW 上 backtrace 不可用非 debug 构建未设rust.debug true的源码构建或任何发布构建的栈帧没有行号指南建议不要报告依赖内部特性custom_mir、lang_items、no_core、rustc_attrs等的用例触发的 ICE。定位完成后指南给出的下一步是按 bug 报告模板提交 issue附上最小复现用例、错误消息、query stack 与 backtrace并说明这是 fuzzer 找到的如适用随后还可以对 bug 做 bisect 以找到引入回归的 commit或用S-has-mcve、E-needs-mcve等标签标注最小化进度。【免费下载链接】rustEmpowering everyone to build reliable and efficient software.项目地址: https://gitcode.com/GitHub_Trending/ru/rust创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考