实例化 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/code/10380" title="装修公司企业网站源码2.0"><img
src="https://img.php.cn/upload/webcode/000/000/002/176175180679310.jpg" alt="装修公司企业网站源码2.0" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/code/10380" title="装修公司企业网站源码2.0">装修公司企业网站源码2.0</a>
<p>装修公司源码，采用DIV+CSS布局，首页顶部采用了超大宽屏banner焦点图切换，带伸缩功能的导航条。首页信息展示量大，有利于SEO优化，首页版块包括，导航，焦点图切换，案例，行业动态，装修经验，装修知识。源码支持伪静态，后台开启即可，服务器必须支持rewrite功能，否则无法实现伪静态功能。信息支持二级分类。后台支持信息批量修改，删除，可以支持，视频，图片，附件上传。</p>
</div>
<a href="/xiazai/code/10380" title="装修公司企业网站源码2.0" 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() 实例化很简单，关键是理解它提供的“线程隔离”特性。用好它可以简化一些多线程编程中的状态管理问题。
