使用InfiniteTimer时全局变量failCount触发UnboundLocalError求助

错误核心：不是线程问题，是Python变量作用域规则 #

这个报错和InfiniteTimer的线程无关，本质是Python的**变量遮蔽（Variable Shadowing）**导致的。当你在函数内部尝试修改全局变量时，如果没有显式声明global，Python会默认把这个变量当作局部变量处理。在tick()里执行failCount += 1时，Python会先尝试寻找局部的failCount，但之前没在函数内定义过这个变量，就抛出了UnboundLocalError。

原始报错代码示例（基于描述推测） #

import threading
from some_module import InfiniteTimer

failCount = 0

def tick():
    # 未声明global，Python判定failCount为局部变量
    failCount += 1
    print(f"失败次数: {failCount}")

timer = InfiniteTimer(1, tick)
timer.start()

临时解决代码的逻辑解释 #

你能解决问题，大概率是用了以下两种方式之一，本质都是绕开局部变量遮蔽：

1. 在tick()开头添加global failCount声明，明确告诉Python要使用全局变量
2. 把failCount放到可变容器（比如列表）里，通过修改容器元素来绕过局部变量限制

正确的global声明写法 #

failCount = 0

def tick():
    global failCount  # 显式声明使用全局变量
    failCount += 1
    print(f"失败次数: {failCount}")

可变容器替代写法（无需global） #

failCount = [0]  # 用列表包装成可变对象

def tick():
    failCount[0] += 1  # 修改列表元素，不会触发局部变量判定
    print(f"失败次数: {failCount[0]}")

技术建议 #

1. 优先用global声明：如果变量确实是全局作用域的，显式声明global最直观，代码可读性最高。
2. 注意线程安全：虽然这次报错不是线程导致，但多线程环境下修改全局变量必须加锁，避免竞态条件：

import threading

failCount = 0
count_lock = threading.Lock()

def tick():
    global failCount
    with count_lock:  # 加锁确保计数操作是原子性的
        failCount += 1
    print(f"失败次数: {failCount}")

3. 封装替代全局变量：如果定时器和计数逻辑耦合度高，建议封装成类，用实例变量替代全局变量，更易维护：

from some_module import InfiniteTimer
import threading

class IPDelayTester:
    def __init__(self):
        self.fail_count = 0
        self.lock = threading.Lock()
        self.timer = InfiniteTimer(1, self.tick)
    
    def tick(self):
        with self.lock:
            self.fail_count += 1
        print(f"失败次数: {self.fail_count}")
    
    def start(self):
        self.timer.start()

# 使用示例
tester = IPDelayTester()
tester.start()

内容的提问来源于stack exchange，提问作者ken205726