如何在工具函数utils/some_fn中访问transformations.py内的metadata对象？

根据你的代码场景，以下几种是最合理的实现方案，按推荐优先级排序：

1. 直接传递参数（最推荐） #

遵循Python「显式优于隐式」的设计原则，直接将metadata对象作为参数传给工具函数，逻辑清晰且无副作用。

修改代码如下：

# transformations.py
from utils import some_fn
from metadata import create_metadata

def transformations(sheet_name, df):
    metadata = create_metadata(sheet_name)
    # ... 其他逻辑
    some_fn(metadata)  # 传递metadata对象

# utils.py
def some_fn(metadata):
    # 直接访问metadata属性
    print(f"当前年份：{metadata.year}，工作表：{metadata.sheet_name}")

优点：

• 逻辑直观，任何人看代码都能明白数据流向
• 无全局状态，测试时可以轻松传入Mock对象
• 完全符合Python的编码规范

2. 使用ContextVars上下文（适合多层调用场景） #

如果你的工具函数嵌套层级深，逐个传递参数太繁琐，可以用Python 3.7+内置的contextvars模块，实现线程安全的上下文共享。

新增/修改代码：

# metadata.py
import contextvars

# 定义上下文变量
metadata_ctx = contextvars.ContextVar("metadata")

class Metadata:
    def __init__(self, year, sheet_name) -> None:
        self.year = year
        self.sheet_name = sheet_name

def create_metadata(sheet_name):
    return Metadata(year=2023, sheet_name=sheet_name)

# transformations.py
from utils import some_fn
from metadata import metadata_ctx, create_metadata

def transformations(sheet_name, df):
    metadata = create_metadata(sheet_name)
    # 将metadata存入上下文，保存token用于后续清理
    token = metadata_ctx.set(metadata)
    try:
        # ... 其他逻辑
        some_fn()
    finally:
        # 确保上下文被清理，避免污染后续请求
        metadata_ctx.reset(token)

# utils.py
from metadata import metadata_ctx

def some_fn():
    # 从上下文获取metadata
    metadata = metadata_ctx.get()
    print(f"当前年份：{metadata.year}，工作表：{metadata.sheet_name}")

优点：

• 无需在每个层级传递参数，简化多层调用逻辑
• 线程安全，多线程/异步环境下不会出现数据串流问题

3. 依赖注入（适合大型项目） #

如果是大型项目，需要解耦模块间的依赖关系，可以用依赖注入的方式，将metadata存入全局容器，工具函数从容器中获取。

示例实现：

# deps.py
class DependencyContainer:
    def __init__(self):
        self.metadata = None

# 创建全局容器实例
deps = DependencyContainer()

# transformations.py
from deps import deps
from metadata import create_metadata

def transformations(sheet_name, df):
    metadata = create_metadata(sheet_name)
    deps.metadata = metadata
    # ... 其他逻辑
    some_fn()

# utils.py
from deps import deps

def some_fn():
    # 从容器获取metadata
    metadata = deps.metadata
    print(f"当前年份：{metadata.year}，工作表：{metadata.sheet_name}")

优点：

• 模块间解耦，便于后续替换或扩展依赖
• 测试时可以轻松替换容器中的metadata为Mock对象

注意：多线程环境下需要给容器加锁，或改用线程局部存储（threading.local()）。

不推荐的方案：全局变量 #

直接将metadata设为全局变量会带来严重的副作用，比如多线程环境下数据混乱、调试困难、测试不便，因此不建议使用。

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