Rust 排错笔记:把报错、最小代码和修复过程记下来
一份报错记录要能脱离原项目阅读
我会先写清触发条件,而不是只贴一段红色终端输出。比如“在同一个函数里先取得集合元素的不可变引用,随后尝试修改集合”,这比“借用出错了”更容易让后来的人判断问题范围。记录里保留 Rust 版本、目标平台、命令和最小模块结构;公司路径、业务字段名和用户样本全部替换成中性名称。这样笔记可以随代码走,也能在 issue 或代码评审里被别人安全地复现。
最小示例应当真的最小。先让它只包含一个 Vec、一个引用和一条会失败的修改;如果删掉某行后错误消失,就说明那行还属于原因的一部分。不要把宏、异步运行时、数据库类型一股脑带进来,否则读者很难分清是借用检查器提示了根因,还是外层框架把信息淹没了。每次删减后重新运行 cargo check,把最终保留下来的报错编号和关键两三行摘出来。
比较修复方案的代价
遇到 E0502,常见修法不止一种。可以先复制需要的小字段,再修改集合;可以把读取结果变成索引,让不可变借用尽早结束;也可以把读取和写入拆到不同的作用域。选择哪一种,要看数据是否大、字段是否可复制、后续是否还需要那条引用。笔记里不必把每种写法都包装成最佳实践,写明为什么这段代码选了它即可。
例如读取到的只是 usize 或布尔值,复制后再 push 往往最清楚。若读取的是一大段字符串,盲目 clone 可能把问题从借用转成不必要的分配。这时可以先保存索引,修改后再按索引读取,或重新组织数据结构。修复完成后,把改前和改后的生命周期画成两三行注释,比一句“缩短借用范围”更有帮助。
让笔记服务下一次排查
最后补一条防回归的测试。它不需要验证编译器报错,而是验证修复后的业务行为:空集合时不越界,命中元素时确实更新,未命中时不误改其他项。若这次问题来自重构,也把触发它的重构动作记下来,例如把临时变量移动到循环外。几周后再遇到类似错误,可以从“最小代码—原因—取舍—测试”这四块直接定位,不必翻聊天记录猜当时改了什么。
一次借用报错让我知道,截图不是很好的排障记录。我要保留的是能重跑的最小代码、完整的错误文本和编译器版本。
rustc --version
cargo check 2> err.txt
例如 E0502 时,我把 err.txt 中的行号和对应函数一起贴到笔记里,再删掉业务名和路径。随后逐步移除无关字段,直到只剩一个可复现的 &mut 与不可变借用冲突。修好后还要写清改动:是缩短了借用作用域,还是复制了小值。这样下次遇到类似提示,不必靠记忆猜。
让诊断信息带路
Rust 的提示通常已经标出不可变借用开始处、可变借用发生处,以及前一个引用最后一次使用的位置。笔记应把这几行连起来写,而不是只留下 E0502。若冲突跨过函数调用,我先把被调函数换成最简单的返回值;错误还在,问题就在调用点附近,错误消失再逐步恢复签名。这个缩小过程比一开始怀疑宏或泛型更快。
最小示例也不能只剩两行而失去业务形状。保留一个代表性的容器和原来的使用顺序,去掉日志、网络和转换层,读者才看得出为什么会先 get 再 push。如果示例的控制流与原代码完全不同,修法很可能被错误地套回去。
编译通过后检查改了谁
有些解法通过了编译,却改了行为。先 clone 再修改,可能修改的是副本;保存索引再删除元素,旧索引也可能已经指向别处。修复记录至少要有一条业务断言,说明预期更新的是哪一项。暂时说不清是否适合公开接口的生命周期写法,也应标成待确认,而不是包装成通用结论。
471



被折叠的 条评论
为什么被折叠?



