mutable成员变量可在const成员函数中修改,用于缓存、计数、锁等辅助状态,不破坏逻辑常量性;必须声明在类内,不可与static/const共用,不影响内存布局,但需确保所有相关字段均标记为mutable。

mutable 成员变量可以在 const 成员函数中被修改
当一个成员函数声明为 const,编译器默认禁止修改任何非静态成员变量。但有些场景下,你确实需要在逻辑“只读”的函数里更新某些辅助状态(比如缓存、访问计数、互斥锁),这时 mutable 就是唯一合法出口。
它不改变对象的逻辑常量性,只告诉编译器:“这个变量允许被 const 函数修改”。关键点是:它必须用于成员变量声明处,且仅对类内变量有效。
-
mutable不能修饰局部变量、全局变量或函数参数 - 不能与
static、const同时修饰同一个变量(mutable static int x;是非法的) - 即使变量是
mutable,也不能绕过线程安全——多线程下仍需同步(如用mutable std::mutex mtx;配合mtx.lock())
典型使用场景:缓存计算结果
避免重复开销较大的计算,又不想破坏接口的 const 语义。例如字符串长度缓存:
class StringWrapper {
std::string data_;
mutable size_t len_cache_;
mutable bool cache_valid_;
public:
StringWrapper(const std::string& s) : data_(s), len_cache_(0), cache_valid_(false) {}
size_t length() const {
if (!cache_valid_) {
len_cache_ = data_.length(); // ✅ 允许修改 mutable 成员
cache_valid_ = true;
}
return len_cache_;
}
};
注意:len_cache_ 和 cache_valid_ 都必须声明为 mutable,否则在 length() 中赋值会触发编译错误:assignment of member 'StringWrapper::cache_valid_' in a const member function。
立即学习“C++免费学习笔记(深入)”;
和 const_cast 的本质区别
有人试图用 const_cast 强转 this 指针来修改普通成员变量,这是危险且通常不合法的:
- 如果原对象本身是
const(比如传入const StringWrapper&),通过const_cast修改会引发未定义行为(UB) -
mutable是语言明确支持的例外机制,编译器和优化器都认可其合法性 -
const_cast绕过类型系统,而mutable是设计契约的一部分
所以:要用缓存、计数、锁等辅助状态,就老实用 mutable;别碰 const_cast 去改非 mutable 成员。
容易忽略的细节:mutable 不影响对象布局或性能
mutable 是纯编译期标记,不改变变量的内存位置、大小或访问速度。但它会影响代码可读性和维护性:
- 过度使用会让“哪些状态真可变”变得模糊,建议只用于真正无副作用的辅助字段
- 调试时注意:
const对象的mutable成员仍可能变化,Watch 表达式里看到它的值跳变是正常的 - 序列化/拷贝构造时,
mutable成员仍参与,不会被自动忽略
最常被漏掉的是忘记把所有相关字段都标为 mutable —— 比如加了 mutable int count; 却忘了 mutable bool dirty;,一写就报错。










