直接在类里用 threading.local() 会失效，因为它是线程级隔离而非实例级隔离；正确做法是在 init 中为每个实例创建独立的 threading.local() 实例。
为什么直接在类里用 threading.local() 会失效
很多人以为只要在类定义里写 local = threading.local()，每个实例就能自动拥有独立的线程局部存储——其实不会。threading.local() 创建的是「线程级」隔离，不是「实例级」或「调用级」隔离。如果多个对象共享同一个 local 实例（比如定义在类体里），它们在同一线程中访问的仍是同一份数据，根本达不到隔离目的。
典型错误现象：AttributeError: '_thread._local' object has no attribute 'value' 或者 A 实例改了 local.x，B 实例在同一时刻读出来也是新值——说明没隔离成功。
- 正确做法是：每个需要隔离上下文的对象，自己持有独立的
threading.local()实例 - 不要把
local定义在类变量位置；也不要在__init__外初始化它 - 若需复用逻辑，可封装成工厂函数或基类，但必须确保每次构造都新建
local
在实例初始化时创建独立的 threading.local()
最稳妥的方式是在 __init__ 中为每个对象分配专属的 threading.local() 实例。这样每个对象在各自线程中操作的都是完全独立的存储空间。
import threading
<p>class Worker:
def <strong>init</strong>(self):
self.local = threading.local() # ✅ 每个实例一份</p><pre class="brush:php;toolbar:false;">def set_value(self, v):
self.local.value = v
def get_value(self):
return getattr(self.local, 'value', None)
立即学习“Python免费学习笔记（深入）”；
使用时注意：self.local 是线程局部的，所以即使多个线程同时调用同一个 Worker 实例的 set_value()，也不会互相覆盖。但如果多个线程共用一个 Worker 实例，又都依赖 self.local 存状态，就要小心生命周期管理——比如线程退出后，该线程绑定的 self.local 数据会自动丢弃，无需手动清理。
避免在类方法中误用 self.local 的属性默认值
threading.local() 不提供默认属性，访问不存在的属性直接抛 AttributeError。不能像 dict 那样用 .get()，也不能靠 __getattr__ 统一兜底（除非你显式重写）。
- 推荐统一用
getattr(self.local, 'key', default)读取，而不是self.local.key - 写入前不用预先检查，直接赋值即可：
self.local.counter = self.local.counter + 1会失败，因为第一次读就报错；应改用getattr(self.local, 'counter', 0) + 1 - 若频繁读写同一字段，可在
__init__中预设初始值：self.local.count = 0
和 concurrent.futures.ThreadPoolExecutor 配合时要注意什么
在线程池里复用 Worker 实例（比如传给 submit()）时，self.local 依然有效——因为线程池中的工作线程会各自维护自己的 local 副本。但要注意：如果在主线程中提前设置了 self.local.x = 1，这个值不会传递到工作线程里，各工作线程的 self.local 是空的。
常见陷阱：
- 误以为
Worker实例能跨线程携带状态——不能，self.local只对当前线程可见 - 在
submit(worker.method, ...)中传方法而非实例，导致self绑定错乱；应传worker.method或用lambda封装 - 忘记
worker对象本身不是线程安全的（比如非local属性被多线程并发修改）
真正需要跨线程传递初始上下文时，得靠参数显式传入，而不是依赖 self.local 的主线程值。
