罗罗编程学习记录

11.15 常见误区与避坑

所属:全栈开发面试题库 / 学习路径 / 11 Rust 全栈

下表是 Rust 学习者在阶段 2 到阶段 8 反复踩过的真实卡点。每条给出「为什么会卡」与「可执行的破解动作」;卡到时先对号入座,不要一上来就 clone() 或 unwrap()。

序号 卡在哪 为什么会卡 怎么破
1 以为 Clone 能解决一切所有权问题 从 GC 语言过来的人习惯「需要就拷一份」,但 Clone 是深复制,在大结构体或热路径上会引入看不见的堆分配与拷贝开销,且编译器不会警告你 先用借用(&T/&mut T)表达所有权;确实需要持有再考虑 Arc/Cow;用 cargo clippy 的 clone_on_ref_ptr/redundant_clone lint 抓多余克隆
2 用 Rc<RefCell<T>> 跨线程导致编译失败 从单线程闭包过来的人觉得 Rc 够用,但 Rc 不实现 Send,编译器报 Rc<RefCell<T>> cannot be shared between threads safely 判断是否需要跨线程;单线程用 Rc<RefCell>,多线程换成 Arc<Mutex> 或 Arc<RwLock>;把错误信息贴到搜索时直接搜 Rc + Send
3 在 Tokio 里调用阻塞 API std::fs::read、std::thread::sleep、同步 Mutex::lock 在 async 任务里会阻塞整个工作窃取线程,导致其它任务排队 改用 tokio::fs、tokio::time::sleep、tokio::sync::Mutex;必须调用阻塞库时用 tokio::task::spawn_blocking 丢到阻塞线程池
4 把 dyn Trait 当零成本抽象 trait 对象走 vtable 动态分发,一次方法调用多一次间接跳转与缓存不友好;递归/trait object 嵌套还可能导致堆分配 能泛型就泛型(单态化、静态分发);只有当集合需要异构元素、插件边界、运行时才确定类型时才用 Box<dyn Trait>;用 cargo asm 或 perf 验证热点
5 default-features = false 引发编译失败 关掉某个 crate 的默认 feature 后,它可能不再启用你用到的模块(如 axum 的 json feature),编译器报「找不到方法」或 trait 未实现 读该 crate 的 Cargo.toml 看 features 列表,显式开启需要的 feature;用 cargo tree -e features 看依赖的 feature 启用情况
6 循环引用导致内存不释放 Rc/Arc 引用计数遇到 A 引用 B、B 引用 A 时计数永不归零,内存泄漏(Rust 不做 GC,但允许这种泄漏) 父持 Rc<Child>,子持 Weak<Parent>;用 std::rc::Weak::upgrade() 取引用;在长生命周期对象里主动 drop 断开环
7 async 块里持有非 Send 类型跨 .await 从 std 搬来的 Rc、RefCell、裸指针在 async 块里跨 .await 点时,编译器要求 Future 是 Send 才能 tokio::spawn,报错 future cannot be sent between threads safely 把 Rc<RefCell<T>> 换成 Arc<Mutex<T>>;或把非 Send 部分隔离到 .await 之前/之后;用 tokio::task::spawn_local 在 LocalSet 上跑
8 Edition 迁移中的 RPIT 捕获变化 2021 edition 开始 impl Trait 返回位置会捕获生命周期,老代码里返回 impl Fn 在不同 edition 下行为不同,迁移后突然报生命周期错误 跑 cargo fix --edition 让编译器给迁移建议;把返回闭包改成 Box<dyn Fn> 或显式标注生命周期;读 Edition Guide 的 2021 章节
9 build.rs 拖慢编译 任何 build.rs 改动都会触发下游 crate 全量重编;build.rs 里去探测系统 C 库、网络请求会让 CI 慢到不可接受 build.rs 只输出必要的 cargo 元数据;用 cargo:rerun-if-changed=PATH/rerun-if-env-changed=VAR 告诉 cargo 何时重跑;缓存 C 库检测结果
10 cargo clippy 与 cargo check 的 lint 差异 cargo check 只跑基础编译检查,cargo clippy 跑上百条 lint;CI 上漏跑 clippy 会让风格问题漏到 main 分支 本地 pre-commit 与 CI 都跑 cargo clippy --all-targets -- -D warnings;把项目自定义 lint(如 #![deny(clippy::unwrap_used)])写在 lib.rs 顶部
11 把 unwrap()/expect() 留在生产代码 从例子里抄来的 unwrap() 在遇到 None/Err 时直接 panic,线上进程崩溃;新手上手时还觉得「编译过了就行」 用 ? 与自定义错误类型向上传播;启动期一次性资源(如配置)可以 expect;业务路径一律返回 Result;CI 用 clippy::unwrap_used 拒绝
12 以为 Send/Sync 是要手动实现的 trait Send/Sync 是 unsafe 自动派生的 marker trait,自己写 impl 是错的;新人看到 impl Send for MyType {} 抄过去反而触发 unsafe 警告 组合自动实现的类型(Arc/Mutex/i32);需要手动实现时用 unsafe impl Send for MyType {} 并写明安全前提;优先派生而非手写
13 泛型返回 impl Trait 与 Box<dyn Trait> 混用出错 在返回 impl Trait 的函数里根据条件返回不同具体类型(两个不同 struct),编译器报「two different types」 两种返回走同一具体类型;或装箱成 Box<dyn Trait>;或用枚举包一层;不要在泛型函数里反复切换抽象形式
14 忽视 Cargo.lock 在 library 与 binary 的差异 写 library 时把 Cargo.lock 提交到仓库会限制下游用户升级依赖;写 binary 时不提交 Cargo.lock 会让构建不可复现 binary 提交 Cargo.lock,library 在 .gitignore 里忽略;读 Cargo Book 的「Lockfile」一节确认约定
15 把 unsafe 当「快」的同义词 新手以为加 unsafe 就能绕过借用检查提速,实际上 unsafe 只放开编译器检查,不生成更快的机器码;滥用 unsafe 反而引入 UB 先 profile 找到真热点;优先用安全抽象(Arc/Mutex/slice::get_unchecked 配合边界检查);用 // SAFETY: 注释写清安全前提并配测试
16 忽略编译时间反馈周期 泛型单态化与 build script 让项目膨胀后 cargo build 从几秒变成几分钟,改一行要等半天 日常用 cargo check 而非 cargo build;拆 workspace 让无关 crate 不参与编译;CI 启用 sccache/mold;用 cargo build -j 控制并发