python初学者应避开直接使用全局变量，而非仅规避其语法陷阱；global声明须位于函数首行且在任何引用前，赋值操作默认创建局部变量，同名变量会静默遮蔽全局变量，真正问题在于状态管理方式不当。
Python初学者不该“避开全局变量的使用陷阱”，而应该避开**直接使用全局变量本身**——因为绝大多数所谓“陷阱”，其实源于对作用域机制的误读，而非全局变量天然有毒。
global 声明必须放在函数最前面，否则 SyntaxError
Python 在编译阶段就检查 global 声明位置，不是运行时。只要在函数内任何地方（哪怕只是读取）用了变量名，之后再写 global x，就会报 SyntaxError: name 'x' is used prior to global declaration。
-
global必须出现在函数体第一层语句中，且在任何对该变量的引用（读或写）之前 - 哪怕只隔了一行
print("debug")，也会触发错误 - 条件分支里不能分散声明：不能在
if里写global x，在else里又用x += 1
不加 global 时，赋值操作自动创建局部变量
这是最常被误解的一点：你写 counter = counter + 1，Python 不会去查“这个 counter 是不是全局的”，而是直接认定你在定义局部变量 —— 然后发现右边的 counter 还没定义，于是抛出 UnboundLocalError。
- 读取全局变量不需要
global（如print(counter)可以正常工作） - 但只要出现赋值符号
=、+=、-=等，Python 就默认该变量为局部作用域 - 即使你本意是想修改全局变量，也必须提前用
global counter“划清界限”
同名局部变量会静默遮蔽全局变量
你可能根本没意识到自己“覆盖”了全局变量。比如：
CONFIG_PATH = "config.yaml" <p>def load_config(): CONFIG_PATH = "local.yaml" # 这行不报错，但创建了新局部变量 with open(CONFIG_PATH) as f: # 读的是 local.yaml，不是 config.yaml return yaml.load(f) </p>
- 这种遮蔽不会警告，也不会报错，但逻辑已经偏离预期
- 调试时容易误以为
CONFIG_PATH还是原来的值，实际函数内完全无关 - 尤其在大型函数中，变量名重复几行后就忘了它曾是全局的
真正的问题不在 global，而在状态管理方式本身
初学者依赖全局变量，往往是因为还没建立“数据流意识”：函数该接收什么、返回什么、状态该存在哪。用全局变量强行维持跨函数状态，等于把逻辑耦合进模块顶层，后续扩展、测试、复用全受影响。
- 替代方案更轻量：把配置/计数器作为参数传入，或封装成类的实例属性
- 如果真要共享状态，考虑
functools.cache、threading.local或显式传递上下文对象，而不是裸露的模块级变量 - 最危险的不是语法错误，而是那种“改了A函数，B函数行为悄悄变了”的隐式依赖
复杂点在于：global 本身语法简单，但它的代价藏在可维护性里；容易被忽略的地方是——你写完 global x 并跑通后，往往就默认“这事解决了”，却没意识到，这个变量现在成了整个模块的隐式契约，谁都能改、谁都可能误改。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
