Rust / 系统课时
使用 RefCell 内部可变性
使用 RefCell 内部可变性
Rust 通常要求只有持有可变引用才能修改数据,但有些对象需要在外部保持不可变接口,同时更新内部状态。RefCell<T> 将借用规则从编译期移到运行时检查,使 &self 方法也能安全地修改内部值,同时要求调用者正确控制借用守卫的生命周期。
学习目标
- 使用
RefCell<T>在&self方法中实现内部可变性 - 理解
borrow、borrow_mut与运行时借用检查的关系 - 识别借用冲突导致的运行时失败,并选择更安全的检查方式
为什么需要内部可变性
普通字段如果只能通过 &self 访问,就不能直接修改。把字段包装为 RefCell<T> 后,外层对象仍可通过不可变引用使用,而真正的可变借用由 RefCell 在运行时创建。这种模式常见于缓存、测试桩、树节点以及 Rc<RefCell<T>> 形式的共享可变状态。
RefCell<T> 并没有放宽 Rust 的核心借用规则:任意时刻仍然只能存在一个可变借用,或者存在一个及以上不可变借用。变化只在于违规行为不再由编译器拒绝,而是在程序运行到借用操作时被发现。
运行时借用如何检查
调用 borrow() 会取得 Ref<T> 共享借用守卫,可以同时存在多个;调用 borrow_mut() 会取得唯一的 RefMut<T> 可变借用守卫。守卫离开作用域或被 drop 后,对应借用才真正结束。
当可变借用仍然存在时再次调用 borrow(),或者任何借用存在时调用 borrow_mut(),都会触发运行时借用错误。try_borrow() 与 try_borrow_mut() 则返回 Result,适合不能接受 panic 的代码路径。

在不可变方法中修改状态
下面的完整程序定义一个计数器。increment 只接收 &self,但通过 RefCell<i32> 修改计数值;随后程序故意保持一个共享借用,并用 try_borrow_mut() 验证此时无法取得可变借用。
use std::cell::RefCell;
struct Counter {
value: RefCell<i32>,
}
impl Counter {
fn new(value: i32) -> Self {
Self {
value: RefCell::new(value),
}
}
fn increment(&self) {
// 可变性位于 RefCell 内部,因此这里只需要 &self。
*self.value.borrow_mut() += 1;
}
fn get(&self) -> i32 {
*self.value.borrow()
}
}
fn main() {
let counter = Counter::new(0);
counter.increment();
counter.increment();
println!("value = {}", counter.get());
// 保持共享借用存活,验证同时取得可变借用会失败。
let reader = counter.value.borrow();
println!("reader = {}", *reader);
println!(
"mutable while reading = {}",
counter.value.try_borrow_mut().is_err()
);
drop(reader);
// 共享借用释放后,可变借用重新变得合法。
let mut writer = counter.value.borrow_mut();
*writer += 3;
drop(writer);
println!("final = {}", counter.get());
}预期输出:
value = 2
reader = 2
mutable while reading = true
final = 5控制借用范围
使用 RefCell<T> 时,最重要的工程习惯是让 Ref 和 RefMut 尽可能短命。不要为了方便把守卫长期保存在变量中,否则后续代码可能在看似无关的位置发生借用冲突。需要提前结束借用时,可以缩小作用域,也可以像示例一样显式调用 drop。
RefCell<T> 适合单线程内部可变性,它本身不能解决跨线程共享问题。多线程环境通常应根据读写模型选择 Mutex<T>、RwLock<T> 等同步原语。内部可变性不是绕过借用规则,而是把必须遵守的同一套规则推迟到运行时执行。