Python跨模块更新全局变量的最优/Pythonic实现方式咨询

在Python中，跨模块同步全局变量的手动方式既繁琐又容易出错，更符合Python风格的做法是通过可变容器（类实例或字典）集中管理共享状态，避免多个模块维护各自的全局变量。以下是两种最优实现方案：

方案1：用类封装共享状态（最推荐） #

将需要共享的状态封装成类的属性，所有模块操作同一个类实例，修改会直接同步，完全符合面向对象的封装原则。

master.py #

import functions as ff

class GameState:
    def __init__(self):
        self.moves = 0

def main():
    state = GameState()
    update(state)
    ff.update(state)
    print(state.moves)  # 输出：2

def update(state):
    state.moves += 1

if __name__ == "__main__":
    main()

functions.py #

def update(state):
    state.moves += 1

方案2：用共享字典实现轻量状态同步 #

如果不想用类，可借助字典（可变对象）传递状态引用，模块间修改字典内的值会自动同步，适合简单场景。

master.py #

import functions as ff

game_state = {"moves": 0}

def main():
    update(game_state)
    ff.update(game_state)
    print(game_state["moves"])  # 输出：2

def update(state):
    state["moves"] += 1

functions.py #

def update(state):
    state["moves"] += 1

为什么不推荐跨模块全局变量？ #

• 全局变量会造成隐式依赖，代码可读性差，排查问题难度高
• 手动同步多模块全局变量极易出现遗漏或错误，维护成本高
• 违背Python"显式优于隐式"的核心设计原则

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