Rust / 系统课时

选择方法接收者

选择方法接收者

Rust 方法的接收者决定方法是在借用实例、可变借用实例,还是直接取得实例所有权。选对 &self、&mut self 与 self,可以让接口准确表达行为,同时避免不必要的移动和借用冲突。

学习目标

  • 区分 &self、&mut self 与 self 对所有权的影响
  • 根据方法是否读取、修改或消费实例选择接收者
  • 判断方法调用后原实例是否还能继续使用

三种接收者改变什么

方法接收者本质上是一个特殊的第一个参数。&self 相当于共享借用当前实例,&mut self 相当于独占的可变借用,而 self 会把实例按值传入方法。

接收者 方法获得什么 能否直接修改普通字段 调用后实例是否仍存在
&self &Self 否 是
&mut self &mut Self 是 是
self Self 可以拥有并移动字段 通常否

&self 最适合查询状态或计算结果;&mut self 用于在原实例上修改状态;self 则适合转换、关闭、构建完成等调用后不再需要原值的操作。

用一个类型观察三种行为

下面的 Article 同时提供只读、修改和消费三类方法。调用者必须把变量声明为可变,才能调用需要 &mut self 的方法。

rust
struct Article {
    title: String,
    reads: u32,
}

impl Article {
    fn title(&self) -> &str {
        &self.title
    }

    fn read(&mut self) {
        // 可变借用期间可以修改当前实例的普通字段。
        self.reads += 1;
    }

    fn into_title(self) -> String {
        // self 已归方法所有,因此可以直接移出其中的 String。
        self.title
    }
}

fn main() {
    let mut article = Article {
        title: String::from("Rust 所有权"),
        reads: 0,
    };

    println!("title={}", article.title());
    article.read();
    println!("reads={}", article.reads);

    let title = article.into_title();
    println!("moved={title}");
}

预期输出

text
title=Rust 所有权
reads=1
moved=Rust 所有权

前两次调用只是借用了 article,借用结束后仍可继续访问它。into_title 接收 self,调用时 article 的所有权被移动进方法,因此此后不能再使用 article。

根据行为选择接收者

如果方法只需要观察实例,优先使用 &self。这样调用者保留所有权,而且同一时刻可以存在多个共享借用,很适合 getter、格式化和只读计算。

如果方法必须在原对象上改变状态,使用 &mut self。调用期间 Rust 会要求该实例没有其他冲突借用,因此方法能够安全地修改字段。调用者持有的是普通局部变量时,通常还需要通过 let mut 允许可变借用。

如果方法的语义就是消费当前值,使用 self。常见场景包括把包装类型转换成内部值、构建器的最终转换,或者调用后对象已经没有继续使用的意义。按值接收还能直接移动非 Copy 字段,而不必克隆它们。

不要用接收者掩盖真实语义

仅仅为了修改局部计算过程,不需要把方法改成 &mut self;只有要改变实例本身时才需要可变接收者。同样,如果方法完成后对象仍然有合理用途,就不应随意使用 self,否则调用者可能被迫克隆整个值。

还有一种特殊情况是内部可变性:即使方法使用 &self,Cell、RefCell、锁等类型仍可能允许其内部状态变化。这是这些类型提供的额外机制,不代表 &self 本身拥有普通字段的可变权限。

选择接收者时可以直接问三个问题:只读当前值就选 &self,要修改同一个实例就选 &mut self,调用完成后应当交出或销毁原值就选 self。接收者因此不仅影响编译器的借用检查,也构成了方法 API 的所有权契约。

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

目录与阅读设置

记录一个想法

选择方法接收者

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

登录哪都通