原因可能在于函数全块的局部名称分类。在 Python 3.14 的函数代码块中，一个名称是否按局部处理，要看整个函数代码块内有没有发生名称绑定，而不是只看读取发生的那一行。只要函数块内任意位置出现对该名称的绑定，又没有 global 或 nonlocal 声明作为例外，函数内所有同名使用都会指向当前块的局部名称。因此，即使模块层或外层函数已有同名变量，函数里在真正赋值之前先读取，也可能抛出 UnboundLocalError。它是 NameError 的子类，表示局部名称尚未绑定到值，不应简单理解成外层变量不存在。适用边界：类体、注解等特殊作用域不能直接套用这一结论，需要按各自作用域另行核对，也不应为了绕过报错就随手加 global 去修改共享状态。
观察：在徐州云龙区台式电脑上只读查看自有程序时，先定位报错行读取的名称，再从函数开头到结尾检查同名绑定操作。结果条件一，若函数内有同名绑定且没有 global 或 nonlocal 例外，那么该名称在整个函数块内按局部处理；结果条件二，若读取发生在绑定之前，报错指向未绑定局部就与本题机制相符；结果条件三，若函数内没有同名绑定，则应按最近的外层作用域继续核对外层值和名称查找，不能直接把所有报错都归为未绑定局部。整个过程只做只读核对，不运行客户脚本，也不调用未知对象。
风险：把 UnboundLocalError 误当成外层变量不存在，容易诱发两类问题。其一，盲目添加 global 可能改动共享状态，让函数之间产生隐蔽耦合，增加排查和回归难度；其二，把类体、注解等特殊作用域直接套用函数规则，可能得出错误结论。由于 UnboundLocalError 是 NameError 的子类，只看异常大类也容易漏掉“局部尚未绑定”这一关键区别。
下一步：可先准备脱敏材料，包括完整报错类型与报错文本、该名称在函数内的绑定位置、是否出现 global 或 nonlocal、最小化且去掉业务数据的代码片段，以及所用 Python 版本说明；不要附带账号、路径、密钥或客户数据。电脑快修网是信息展示与第三方维修对接平台，400-877-9605只作咨询，实际范围和安排需确认。