rust-clip-stag-debt-rdct

name	rust-clip-stag-debt-rdct
description	Staged workflow for clearing Rust clippy debt in large repos without thrashing — compile/API migration first, then low-risk mechanical lints in batches, then signature/type refactors, with cargo check between phases.

rust clippy staged debt reduction

何时用：

• 大型 Rust 仓 cargo clippy -- -D warnings 爆出成批告警。
• 仓内同时存在编译迁移债、机械 lint、签名/结构重构债。
• 需要压低来回 thrash。

核心法则：

1. 先绿 cargo check，后打 clippy。
2. 先 API/编译迁移，后机械 lint，最后结构性 lint。
3. 机械债按文件簇分批清；每批后复验。
4. 若修完一层告警，clippy 常会暴露下一层；属常态，不算回退。
5. 对机械批次，优先用子代理并行；对签名/结构批次，集中主线处理。

推荐阶段：

阶段 0：基线

• 跑 cargo check
• 若不绿：只修编译/API 迁移
• 典型迁移：多参函数改 input struct、builder/adapter 调用面统一、import/re-export 收口
• 未回绿前，不做 clippy 清债

阶段 1：低风险机械债

优先处理：

• needless_range_loop
• if_same_then_else
• redundant_field_names
• needless_borrows_for_generic_args
• cloned_ref_to_slice_refs
• useless_conversion
• useless_format
• needless_option_as_deref
• filter_map_bool_then
• nonminimal_bool

做法：

• 按模块簇分批：如 hmm/*、ict/*、math/indicators/*
• needless_range_loop 只改成 iter()/iter_mut()/enumerate()/skip()/take()，不混入业务改动