如何将Python代码拆分到多个文件并避免不合理的链式导入问题

原有实现的核心问题 #

• 导入链路过长，形成链式透传依赖，修改任意上游模块都会影响全链路下游代码
• 存在大量冗余导入：比如classes.py中未使用u、colors变量，却做了导入
• 逻辑强耦合全局变量：Entity类直接依赖全局grid变量，无法复用或动态切换网格
• 存在语法笔误：__init__方法多写了一个下划线、循环关键字true应为大写True、classes.py中导入的map模块不存在（实际文件名为grid_map.py）

优化方案（遵循单一职责、最小依赖原则） #

1. 模块功能拆分&代码调整 #

1.1 常量配置模块：config.py（原initialisation.py更名，无任何依赖）

# config.py
U = 30
COLORS = ('blue', 'red')

1.2 网格模块：grid_map.py（仅依赖自己需要的常量）

# grid_map.py
from config import U, COLORS
grid = [0, 1]

1.3 实体类模块：entities.py（原classes.py更名，不依赖全局变量，依赖通过参数注入）

# entities.py
class Entity:
    def __init__(self, x, color):
        self.x = x
        self.color = color

    def move(self, grid):
        print(grid[self.x + 1], self.color)

1.4 入口模块：main.py（统一管理所有依赖，不做链式透传）

# main.py
from config import U, COLORS
from grid_map import grid
from entities import Entity

if __name__ == "__main__":
    foo = Entity(0, COLORS[0])
    bar = Entity(0, COLORS[1])
    while True:
        foo.move(grid)
        bar.move(grid)

2. 可选保留objects.py的调整方案 #

如果你需要单独维护实例声明，可以保留objects.py，无需导入无关变量：

# objects.py
from config import COLORS
from entities import Entity

foo = Entity(0, COLORS[0])
bar = Entity(0, COLORS[1])

对应main.py调整为：

# main.py
from grid_map import grid
from objects import foo, bar

if __name__ == "__main__":
    while True:
        foo.move(grid)
        bar.move(grid)

优化收益 #

• 无链式依赖：所有模块仅依赖自己需要的内容，上游修改不会连带影响无关下游模块
• 逻辑解耦：Entity类不再绑定全局grid，可灵活传入不同网格做测试、扩展
• 无冗余代码：每个模块的导入都是实际用到的内容，可维护性大幅提升

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