子线程异常默认不传播至主线程，仅打印traceback后静默退出；可用threading.local（需共享对象）、queue.queue（推荐）或concurrent.futures.threadpoolexecutor（自动传播）三种方式捕获并传递异常。
子线程异常默认不会传播到主线程
Python 的 threading.Thread 启动后，如果子线程内抛出未捕获异常，它只会打印 traceback 到 sys.stderr，然后静默退出——主线程完全感知不到，join() 也不会报错。这是最常被误以为“程序卡住”或“异常丢失”的根源。
常见错误现象：
- 主线程调用
t.join()正常返回，但子线程其实已崩溃 - 日志里看到
Exception in thread Thread-1:但没地方 catch - 用
try/except包裹t.start()完全无效
用 threading.local 存储异常对象（轻量、无第三方依赖）
核心思路：在子线程中主动把异常对象存到线程局部存储，主线程通过约定位置读取。适用于简单场景，不涉及跨线程通信开销。
实操建议：
- 定义全局
thread_local = threading.local() - 子线程函数开头加
thread_local.exc = None初始化 - 子线程
try/except中捕获后赋值：thread_local.exc = sys.exc_info() - 主线程
t.join()后检查：if getattr(thread_local, 'exc', None): raise thread_local.exc[1]
注意：threading.local 是线程隔离的，主线程无法直接访问子线程的 thread_local 实例，必须让子线程把异常写入一个**主线程可访问的共享对象**（比如类实例属性、队列、或带锁的字典）。更稳妥的做法是用下面的队列方式。
用 queue.Queue 传递异常（推荐，线程安全）
queue.Queue 天然线程安全，适合在子线程结束前把结果或异常塞进去，主线程统一收口处理。这是生产环境最常用、最清晰的方式。
python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能，主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践；生成安全服务方案文档；核心要点生成技术架构设计文档；生成任何需要专业排版的Word文档；核心库 : python-docx；使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns；标准代码模板；1. 文档初始化；2. 字体设置（必须！它将相关步骤、工具调用和结果整理方式集
实操建议：
- 创建一个
result_queue = queue.Queue(maxsize=1) - 子线程函数末尾：
result_queue.put((None, result))或异常时：result_queue.put((exc_type, exc_value, exc_traceback)) - 主线程调用
t.join(timeout=...)后，result_queue.get_nowait()取值；若超时未取到，说明线程卡死或未退出 - 拿到三元组后，用
raise exc_value.with_traceback(exc_traceback)精确还原异常栈
性能影响几乎为零；兼容所有 Python 版本；能自然支持多子线程批量收集结果与异常。
使用 concurrent.futures.ThreadPoolExecutor（高阶封装，自动处理）
如果你不需要手动管理 Thread 生命周期，直接用 ThreadPoolExecutor 是最省心的选择——它内部就用类似 queue.Queue 的机制做了异常捕获和传播。
实操建议：
- 提交任务用
executor.submit(func, *args)，返回Future对象 - 调用
future.result()会**同步阻塞直到完成，并原样抛出子线程异常**（包括类型、消息、完整 traceback） - 不用手动
join，不用管线程创建销毁；支持as_completed()并发等待多个结果 - 注意：
future.exception()只返回异常对象，不 re-raise；真正触发传播的是.result()
唯一容易忽略的点：别忘了在 with ThreadPoolExecutor() as executor: 块内调用 .result()，否则异常可能被延迟到 __exit__ 时才抛出，且堆栈指向上下文管理器而非原始函数。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
