实例化 threading.local() 可创建线程隔离的局部数据对象，如 local_data = threading.local()，各线程读写独立，适用于跨函数传参、保存线程绑定状态等场景。
在 Python 中，threading.local() 是一个用于创建线程局部数据的类。每个线程对这个局部数据的读写都是独立的，互不干扰。这意味着你可以在多线程环境中为每个线程保存独立的状态。
如何实例化 thread.local()
实例化 threading.local() 非常简单，就像创建普通对象一样：
import threading
<h1>创建一个全局的 thread.local 实例</h1><p>local_data = threading.local()</p><p>def worker():</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac">macOS UI 自动化技能包 —— 用 Python 控制你的 Mac</a>
<p>让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript
系统要求
macOS 14+ (Sonoma)
Python 3.9+
需要开启：辅助功能 + 屏幕录制权限</p>
</div>
<a href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>每个线程都可以设置自己的属性</h1><pre class='brush:python;toolbar:false;'>local_data.value = threading.current_thread().name
print(f"当前线程: {threading.current_thread().name}, value = {local_data.value}")创建多个线程
t1 = threading.Thread(target=worker, name="Thread-1") t2 = threading.Thread(target=worker, name="Thread-2")
t1.start() t2.start()
t1.join() t2.join()
上面代码中，local_data = threading.local() 就是 thread.local 的实例化过程。每个线程调用 worker() 时都会设置自己的 value 属性，彼此之间不会冲突。
使用场景说明
thread.local 常用于以下情况：
- 在同一个线程中跨函数传递数据，避免层层参数传递
- 保存数据库连接、用户会话等与线程绑定的状态
- 实现线程安全的日志上下文或请求上下文（如 Flask 的 g 对象）
注意事项
使用 thread.local 时需要注意：
- 每个线程第一次访问属性前必须先设置，否则会抛出 AttributeError
- 不能在线程间共享数据，这是设计目的，也是限制
- 子线程不会继承父线程的 local 数据（除非是同一 thread 对象）
基本上就这些。thread.local() 实例化很简单，关键是理解它提供的“线程隔离”特性。用好它可以简化一些多线程编程中的状态管理问题。
