threading 是 Python 標準庫提供的高階執行緒介面,設計參考 Java 執行緒模型,但簡化了許多功能 (無優先級、執行緒群組、強制停止等)。本文系統整理核心類別、常用方法與實務範例。
| 函數 | 說明 |
|---|---|
current_thread() | 回傳當前執行緒物件 |
enumerate() | 列出所有啟動未結束的執行緒清單 |
active_count() | 執行中執行緒數量 (等同 len(enumerate())) |
Thread:執行緒本體Lock / RLock:互斥鎖 / 可重入鎖Condition:條件變數 (配合鎖實現等待/通知)Semaphore / BoundedSemaphore:訊號量Event:簡易執行緒同步旗標Timer:延遲執行local:執行緒區域儲存import threading
def worker(msg):
print(f"[{threading.current_thread().name}] {msg}")
t = threading.Thread(target=worker, args=("Hello",), name="Worker-1")
t.start()
t.join()
class MyThread(threading.Thread):
def __init__(self, msg):
super().__init__()
self.msg = msg
def run(self):
print(f"[{self.name}] {self.msg}")
t = MyThread("Hello from subclass")
t.start()
t.join()
Thread(group=None, target=None, name=None, args=(), kwargs={})
group:保留欄位,必須為 None。target:要執行的可呼叫物件。name:執行緒名稱,除錯時顯示於 enumerate()。args/kwargs:傳給 target 的參數。start():啟動執行緒 (只能呼叫一次)。join(timeout=None):阻塞呼叫執行緒,直到該執行緒結束或逾時。is_alive():執行緒是否正在執行。daemon 屬性:守護執行緒,主程式結束時強制結束,不阻塞程式退出。import threading, time
def long_task():
print("子執行緒開始")
time.sleep(2)
print("子執行緒結束")
t = threading.Thread(target=long_task)
t.start()
print("主執行緒等待...")
t.join()
print("主執行緒繼續")
輸出順序:主執行緒等待... → 子執行緒開始 → (2秒後) 子執行緒結束 → 主執行緒繼續
run() 而非 start():會在當前執行緒同步執行,失去並行效果。Event)。Lock 或 queue.Queue 保護。daemon=True,避免主程式無法退出。掌握 threading 基礎,是編寫並發 Python 程式的第一步;複雜場景建議改用 concurrent.futures 或 asyncio 獲得更高層級抽象。