SuperAPI AI 工具集

rust-profiling

编程与开发

查看项目

更新于 11-18 09:39

技能介绍

用途

该技能在需要剖析 Rust 性能、减小二进制体积、测量单态化膨胀、编写 Criterion 基准测试,或解读火焰图与 perf 输出时触发。其权限为只读:只向对话输出指导报告和命令记录,不修改源码,也不改动远程资源。完成标准是产出一份报告,指明热点路径、膨胀来源、体积贡献者或基准测试结果,并给出下一步行动。

输入

  • 目标二进制或基准测试(必需):要测量的程序、测试或 Criterion 基准。
  • 构建配置(无法推断时必需):带调试符号的 release 配置(release-with-debug 或 CARGO_PROFILE_RELEASE_DEBUG=true)。
  • 剖析工具(必需):cargo-flamegraph、cargo-bloat、cargo-llvm-lines、Criterion、perf、heaptrack 或 valgrind --tool=dhat。
  • 可选输入:用于对比的已保存基线,或需要标注的特定函数。

主要能力与使用方式

  1. 构建剖析版本:使用 debug = true 的 release 配置,或设置 CARGO_PROFILE_RELEASE_DEBUG=true;需要行级归因且构建更快时用 debug = 1;需要更好调用图时设置 RUSTFLAGS="-C force-frame-pointers=yes"。完成标志是二进制含调试符号且帧指针按需配置。
  2. 生成火焰图:运行 cargo flamegraph --bin <name> -- <args>,或用 perf record -g 配合 stackcollapse-perf.pl 与 flamegraph.pl。关注宽顶部帧、意外的标准库与分配器帧、细闭包帧。完成标志是火焰图 SVG 能识别热点叶子。
  3. 用 cargo-bloat 测量体积:运行 cargo bloat --release -n 20、cargo bloat --release --crates 或 cargo bloat --release --filter <crate>,与保存的输出对比前后变化。完成标志是列出最大体积贡献者。
  4. 用 cargo-llvm-lines 测量单态化膨胀:运行 cargo llvm-lines --release | head -40。Copies 计数高通常意味着泛型单态化,需阅读函数及其类型参数确认;可通过薄泛型包装加具体内部函数来减少。完成标志是列出 LLVM IR 与副本最多的函数。
  5. 编写 Criterion 基准测试:将 criterion 加入 dev-dependencies,创建 benches/<name>.rs 并使用 criterion_group! 与 criterion_main!,用 black_box 防止优化,与保存的基线对比。完成标志是基准文件可运行并产出报告。
  6. 在 Linux 上用 perf 剖析:用 perf record -g -F 999 <binary> 记录,用 perf report 或 perf annotate 查看,用 perf stat 收集快速计数器。完成标志是热点函数与调用图可见。
  7. 用 heaptrack 或 DHAT 剖析分配:运行 heaptrack <binary> 并用 heaptrack_print 查看,或运行 valgrind --tool=dhat <binary> 并用 dh_view.html 查看 dhat-out.*。完成标志是识别出分配热点与生命周期。

失败与恢复

  • 无调试符号:用 debug = true 或 debug = 1 重新构建。
  • 调用图不完整:设置 RUSTFLAGS="-C force-frame-pointers=yes",并用 setarch $(uname -m) -R 关闭 ASLR。
  • 火焰图权限被拒:将 perf_event_paranoid 调低到 1,或用 sudo;macOS 上使用 DTrace。
  • 基准结果噪声大:提高 Criterion 的 measurement_time、sample_size 和 warm_up_time。
  • 分配剖析数据过大:过滤到更小的工作负载或缩短剖析时长。

输出

  • 结构化指导报告,包含所选工具、测量结果与解读。
  • 建议的下一步行动:代码改动、新基准测试或进一步剖析。
  • 可复现测量的命令。

适用场景与限制

适用于 Rust 项目的性能热点定位、二进制体积优化、泛型单态化分析与内存分配剖析。该技能为只读指导,不自动修改代码;具体效果取决于目标程序与工具环境,资料未提供收费、价格或平台支持范围等信息。