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 的代码路径。

RefCell 运行时借用状态与冲突关系

在不可变方法中修改状态

下面的完整程序定义一个计数器。increment 只接收 &self,但通过 RefCell<i32> 修改计数值;随后程序故意保持一个共享借用,并用 try_borrow_mut() 验证此时无法取得可变借用。

rust
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());
}

预期输出:

text
value = 2
reader = 2
mutable while reading = true
final = 5

控制借用范围

使用 RefCell<T> 时,最重要的工程习惯是让 Ref 和 RefMut 尽可能短命。不要为了方便把守卫长期保存在变量中,否则后续代码可能在看似无关的位置发生借用冲突。需要提前结束借用时,可以缩小作用域,也可以像示例一样显式调用 drop。

RefCell<T> 适合单线程内部可变性,它本身不能解决跨线程共享问题。多线程环境通常应根据读写模型选择 Mutex<T>、RwLock<T> 等同步原语。内部可变性不是绕过借用规则,而是把必须遵守的同一套规则推迟到运行时执行。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

使用 RefCell 内部可变性

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通