Python中如何避免反复传递DataFrame和配置？全局变量与主函数封装哪种更好？

以下两种方案都可以实现配置、DataFrame的全局共享，无需反复传参：

• 方案1：模块级共享上下文（最适合小型项目）
  Python模块天然为单例，所有导入位置读取的是同一份实例，只需新建单独的context.py文件存储共享状态即可：

# context.py
import pandas as pd
# 预先定义要共享的变量，初始为None
config: dict | None = None
market_df: pd.DataFrame | None = None

数据加载完成后给变量赋值：

# stratego.py
import context

def start(config):
    # 先将配置存入共享上下文
    context.config = config
    data = dt.Data(config['data'])
    if config['data']['type'] == 'yahoo':
        df = data.get_yahoo_data()
    elif config['data']['type'] == 'csv':
        df = data.get_csv_data()
    else:
        return False
    # 将加载完成的DataFrame存入共享上下文
    context.market_df = df
    # 后续Strategy类内部直接导入context读取即可，不需要传参
    trades = str.Strategy()
    tradeBook = trades.run()

• 方案2：单例类封装上下文（适合中大型项目，方便加状态校验、日志等逻辑）

# context.py
import pandas as pd

class AppContext:
    _instance = None
    # 禁止外部直接实例化
    def __new__(cls, *args, **kwargs):
        if not cls._instance:
            cls._instance = super().__new__(cls)
            cls._instance.config = None
            cls._instance.market_df = None
        return cls._instance

    # 可选：加初始化校验，防止重复赋值
    def init(self, config: dict, df: pd.DataFrame):
        if self.config is not None:
            raise RuntimeError("AppContext已经初始化，不可重复赋值")
        self.config = config
        self.market_df = df

使用时直接调用单例即可：

# stratego.py中初始化
from context import AppContext

def start(config):
    # 加载df逻辑省略
    AppContext().init(config, df)

# 其他类中读取
from context import AppContext
class Strategy:
    def run(self):
        ctx = AppContext()
        config = ctx.config['strategy']
        df = ctx.market_df
        # 后续逻辑省略

直接用全局作用域变量的问题 #

这种做法仅适用于100行以内的一次性脚本，正式项目完全不推荐，缺点如下：

• 可测试性极差：全局状态在所有测试用例中共享，无法单独给不同测试用例传入不同配置、不同测试数据
• 无法支持多实例运行：如果后续需要同时跑多个不同配置的策略任务，全局变量会互相覆盖，完全无法实现
• 排查问题成本高：任何位置都可以修改全局变量，出现状态异常时很难定位是哪段代码修改了数值
• 可读性差：函数/类的依赖没有显式声明，维护代码时无法直观判断某段逻辑依赖哪些数据

封装主函数的优势 #

封装主函数是Python官方推荐的最佳实践，优势如下：

• 状态天然隔离：每次调用主函数传入的参数互不干扰，后续扩展多任务、多线程运行都非常方便
• 可测试性强：测试时直接传入测试配置、模拟数据即可测试对应逻辑，不需要修改全局状态
• 依赖明确：函数的参数就是它的所有依赖，维护代码时一目了然
• 避免导入副作用：如果把逻辑写在全局作用域，模块被导入时就会直接执行逻辑，无法控制运行时机

如果确实不想频繁传参，优先用前面提到的共享上下文方案，既可以避免重复传参，也比直接用全局作用域变量更容易管控状态。

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