可变与不可变(Mutable vs Immutable)

可变性描述对象内容能否原地改变;可哈希性描述能否作为字典键或集合元素。两者相关但不等价,嵌套元素与自定义相等规则都要考虑。

一句话定义

可变性描述对象内容能否原地改变;可哈希性描述能否作为字典键或集合元素。两者相关但不等价,嵌套元素与自定义相等规则都要考虑。

为什么重要

  • 决定对象能不能做字典的键、集合的元素:只有可哈希(通常意味着不可变)的对象才行。
  • 决定共享是否安全:对象及其被访问的内部状态都不变时更容易安全共享;可变对象共享就要小心。
  • Python 最著名的坑之一——可变默认参数——就源于此。

使用边界

可变实例也可能按身份哈希;不可变元组若含不可哈希元素,仍不能做键。frozendict 从 Python 3.15 才是内建类型,它也不会递归冻结可变的值。

原理 / 图解

类型 可变? 可哈希? 备注
int float bool str bytes 否 是 “修改”其实是创建新对象
tuple 否 仅当所有元素可哈希 元组里装列表 → 不可哈希
frozenset 否 是 不可变集合
frozendict(3.15 新增) 否 仅当键值都可哈希 PEP 814
list dict set bytearray 是 否
自定义类实例 默认是 默认按身份哈希 frozen=True 禁止常规字段重新赋值,不递归冻结字段内容

Python 3.15(2026-10-09 发布)新增内建 frozendict:不是 dict 的子类、保持插入顺序但比较时不考虑顺序、键值都可哈希时可哈希:https://docs.python.org/3.15/whatsnew/3.15.html#pep-814-add-frozendict-built-in-type

可变默认参数陷阱的原理:

图 1

Python 官方教程专门警告:“默认值只计算一次。当默认值是列表、字典等可变对象时,这会造成差异”:https://docs.python.org/3/tutorial/controlflow.html#default-argument-values

可运行示例

# 文件:examples/19_mutability.py
# 可变 vs 不可变;以及最经典的坑:可变默认参数
import sys
print("Python", sys.version.split()[0])

s = "abc"
try:
    s[0] = "z"
except TypeError as e:
    print("str 不可变:", e)

t = (1, [2, 3])           # 元组不可变,但里面的列表可变
t[1].append(4)
print("元组里的列表被改了:", t)
try:
    hash(t)
except TypeError as e:
    print("因此这个元组不可哈希:", e)

# 经典坑:默认参数只在函数定义时求值一次
def bad(item, bucket=[]):
    bucket.append(item); return bucket
def good(item, bucket=None):
    bucket = [] if bucket is None else bucket
    bucket.append(item); return bucket
print("bad :", bad(1), bad(2))
print("good:", good(1), good(2))

# 不可变带来的好处:可作为字典键、可安全共享
cache = {(3, 4): 5.0}
print("元组做键:", cache[(3, 4)])

# Python 3.15 新增内置 frozendict(PEP 814):不可变、可哈希的字典
if sys.version_info >= (3, 15):
    fd = frozendict(model="deepseek", temperature=0.2)
    print("frozendict:", fd, "| 可哈希:", hash(fd) == hash(frozendict(temperature=0.2, model="deepseek")))
    try:
        fd["model"] = "x"
    except TypeError as e:
        print("frozendict 不可修改:", e)

一稿留存输出(Python 3.15.0):

Python 3.15.0
str 不可变: 'str' object does not support item assignment
元组里的列表被改了: (1, [2, 3, 4])
因此这个元组不可哈希: unhashable type: 'list'
bad : [1, 2] [1, 2]
good: [1] [2]
元组做键: 5.0
frozendict: frozendict({'model': 'deepseek', 'temperature': 0.2}) | 可哈希: True
frozendict 不可修改: 'frozendict' object does not support item assignment

注意 bad : [1, 2] [1, 2]:两次调用返回的是同一个列表对象,所以打印时两个都显示 [1, 2]。

常见误区

  • “元组不可变,所以元组里的东西都不能变”:元组只保证“装的是哪几个对象”不变,对象本身如果可变仍可修改。
  • s += "x" 修改了字符串:实际上创建了新字符串并重新绑定名字。循环里大量拼接字符串应使用 "".join(...)。
  • 用 None 以外的可变对象作默认参数:统一使用 None 再在函数体内创建。Ruff 规则 B006 能检测这一问题:https://docs.astral.sh/ruff/rules/mutable-argument-default/
  • 以为 frozen=True 的 dataclass 完全不可变:它的字段如果是列表,列表本身仍可变(与元组同理)。

与 AI 开发的关系

  • 缓存需要不可变的键:functools.cache 要求参数可哈希。把配置做成 frozendict 或元组,才能用作缓存键(例如缓存某组生成参数下的模型输出)。
  • Pandas 3.0 的 Copy-on-Write:从“到处都可能原地修改”转向“派生表表现为副本、必要时复制底层数据”的语义,减少了意外修改原数据(见 k1.lib.pandas)。
  • 多线程 / free-threaded Python:去掉 GIL 后,共享可变对象的并发修改风险更直接暴露,不可变数据在并发中更安全(见 k1.py.threading)。

延伸阅读

理解检查

含列表的元组为什么不能作为字典键?

参考答案:元组的哈希依赖所有元素可哈希,而 list 没有可用的哈希值。

核验与复现

核验日期:2026-10-14。示例状态:运行通过;Python 3.15 的 frozendict 分支未执行。本轮日志:19_mutability.py。

配套代码与核验资料

继续浏览基础 返回知识 →返回顶部 ↑
本篇目录
教程图解100%
教程图解