一句话定义
可变性描述对象内容能否原地改变;可哈希性描述能否作为字典键或集合元素。两者相关但不等价,嵌套元素与自定义相等规则都要考虑。
为什么重要
- 决定对象能不能做字典的键、集合的元素:只有可哈希(通常意味着不可变)的对象才行。
- 决定共享是否安全:对象及其被访问的内部状态都不变时更容易安全共享;可变对象共享就要小心。
- 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
可变默认参数陷阱的原理:
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)。
延伸阅读
- Python 数据模型(可变性与可哈希):https://docs.python.org/3/reference/datamodel.html
- 术语表 hashable:https://docs.python.org/3/glossary.html#term-hashable
- PEP 814 – frozendict:https://peps.python.org/pep-0814/
理解检查
含列表的元组为什么不能作为字典键?
参考答案:元组的哈希依赖所有元素可哈希,而 list 没有可用的哈希值。
核验与复现
核验日期:2026-10-14。示例状态:运行通过;Python 3.15 的 frozendict 分支未执行。本轮日志:19_mutability.py。
配套代码与核验资料