如何按效率组织 Python 函数和文件？

2026-11-04数据小陈

结论

通常不必为了提高运行效率而合并多个 Python 文件，也不必把类和普通函数分开存放。按职责和关联性组织代码即可。遇到性能问题时，再通过测量找出耗时位置并针对性优化。

如何组织文件和函数

可以按功能划分模块，把需要一起维护的代码放在同一处。例如：

my_app/
    main.py
    users.py
    reports.py

users.py 可以放用户相关的数据处理函数和类，reports.py 放报表逻辑。类和函数是否放在同一个文件里，取决于它们是否属于同一项功能，不必只因为一个是类、一个是函数就拆开。

单个模块通常可以按这个顺序组织：导入、模块常量、类和函数，最后是程序入口。例如：

DEFAULT_LIMIT = 100


def load_records(path):
    # 读取并返回记录
    ...


def summarize(records):
    # 汇总记录
    ...


if __name__ == "__main__":
    records = load_records("records.csv")
    print(summarize(records))

函数的排列顺序以便于阅读和查找为准。入口函数可以放在前面，辅助函数也可以放在前面，团队内部保持一致就好。

全局变量怎么处理

模块级变量适合存放常量，比如默认值或固定配置。对于会变化的状态，优先通过函数参数传入，再用返回值传出：

def calculate_total(items, tax_rate):
    subtotal = sum(items)
    return subtotal * (1 + tax_rate)

这样函数依赖什么会更清楚，也更方便单独理解和复用。如果确实需要共享模块状态，可以放在模块中，但要谨慎处理可变对象，避免多个函数不知不觉地修改同一份状态。

拆分文件与运行效率

把代码拆成多个模块，主要是为了改善组织和维护。Python 首次导入模块时会执行其中的顶层代码；同一进程后续导入时，通常会复用已经加载的模块。因此，导入和初始化代码可能影响启动过程，但不能仅凭文件数量判断程序会变快还是变慢。

拆分模块时，应避免不必要的顶层计算和循环导入。如果目标是改善性能，可以先用性能分析工具定位耗时，再判断是否需要调整模块初始化或具体算法。

Python 和 JavaScript 是否一样

不能把所有解释型语言都视为同一种情况。Python 和 JavaScript 的模块系统、导入时的执行行为以及运行环境各有规则。代码组织上可以遵循相似原则，比如按职责拆分、减少隐式共享状态；涉及导入开销或模块行为时，则应根据具体语言和运行环境判断。