用途
该技能用于指导 Rust 开发者在遇到借用检查器报错时,优先调整所有权与借用结构,而不是用 clone、Rc、RefCell 或 Arc<Mutex<_>> 来消除错误。它把借用检查器视为“所有权被模糊处理的位置地图”,而非需要绕开的障碍。
主要能力
- clone 可解释性规则:每个 clone 都必须能用一句非“借用检查器报错了”的话解释清楚。为真实需求(如值必须比借用活得更久)而 clone 是合理的;仅为消除错误而 clone 则是被推迟的设计决策。
- 阅读错误而非绕开:E0502(不可变借用仍存活时进行可变借用)和 E0499(同一位置两次可变借用)指出的是生命周期冲突,修复应落在错误所描述的结构上。示例中利用
Copy类型在let后结束借用,从而无需 clone。 - 借用拆分:借用检查器通过方法调用跟踪整个值,但通过直接字段访问可分别跟踪字段。对
&mut self方法中同时需要self.other_field的经典假冲突,可先解构:let Self { connections, log, .. } = self;,使两个字段独立借用。split_at_mut返回同一 slice 的两个不相交&mut半部;解构不够时可提取接收两个字段的自由函数。 - 参数位置选用最廉价类型:只读参数用
&str而非&String、&[T]而非&Vec<T>、impl AsRef<Path>而非PathBuf。签名若只读却接收String,会迫使每个调用方 clone——问题在签名本身。 - Cow 用于真正的借用或拥有:当常见路径原样返回输入、罕见路径才分配时,
Cow<'_, str>才值得使用。示例中仅在输入含尖括号时分配,否则借用。 - Rc/Arc/RefCell/Mutex 的正当场景:仅当运行时结构确实有多个所有者、且没有单一所有者比其余活得更久时才合理;不能仅因单一所有者不便命名就使用。添加 RefCell 前需运行 SHARED-STATE.md 中的四问测试;决策表在 CLONE-DECISIONS.md;通过一句话测试的句柄 clone 见 SHARED-STATE.md。
- mem::take 与 mem::replace:通过留下默认值从
&mut中移出值,解决“需要拥有但只有可变借用”的情况,例如let old = mem::take(&mut self.buffer);。 - 避免静态可变状态:持有可变或惰性初始化状态的 static 是无人写下的生命周期和难以追踪的所有权故事。应传递值,或将其放在拥有该工作的类型中。
使用方式
在 Rust 代码中遇到借用检查错误或审查 clone 使用时,按上述规则调整结构。相关主题分工:改写正确代码的表达方式属于 /idiomatic-rust;将不变量建模进类型属于 /type-driven-design;错误类型属于 /rust-errors;跨 .await 点的共享状态属于 /async-rust。
验证
保留或移除 clone 不改变行为,因此“仍能工作”的断言由测试套件在仓库配置的 lint 级别下确认:
cargo clippy --all-targets # 仅当仓库无 lint 配置时才加 -- -D warnings
cargo test
clippy::redundant_clone 属于 nursery 且默认关闭——可用 cargo clippy -- -W clippy::redundant_clone 一次性运行作为提案生成器,但不要写入仓库 lint 配置;其发现是候选,不是直接修改。
适用场景与限制
适用于 Rust 代码中借用冲突的解决、clone 使用的审查与重构。限制在于:该技能不改变程序行为,验证依赖测试套件;共享状态决策需参考配套文档;不涉及错误类型设计、异步共享状态等属于其他技能的主题。