Python导入错误：无法导入名称——跨模块导入变量问题求助

你遇到的其实不是名称空间污染，而是**循环导入（Circular Import）**问题——这在Python模块互相引用时很常见，我来给你拆解清楚并提供可行的解决办法：

问题根源分析 #

你的模块依赖链触发了加载顺序冲突：

1. 运行script.py时，会导入config模块，也就是加载config/__init__.py
2. __init__.py第一行就执行from config.output_config import output_data，这会触发output_config.py的加载
3. output_config.py开头又执行from config import BUCKET，但此时config模块（也就是__init__.py）还没加载完——它还没来得及定义BUCKET就被打断去加载output_config了
4. 这就导致output_config.py试图导入一个还不存在的BUCKET变量，直接抛出错误

可行的解决方案 #

方案1：延迟导入（把导入放到函数内部）

最简单的临时修复是调整output_config.py的导入时机，避开模块加载阶段的循环：

# config/output_config.py
def output_data():
    # 只有当函数被调用时才导入BUCKET，绕开模块加载时的依赖冲突
    from config import BUCKET
    # 这里写你的业务逻辑，比如使用BUCKET操作存储
    print(f"Using bucket: {BUCKET}")

这种方法不需要改动模块结构，适合快速解决小场景的循环导入问题。

方案2：重构模块，拆分共享变量（推荐）

如果你的项目会逐渐变大，最好的方式是把共享配置变量单独抽离，彻底打破循环依赖：

1. 创建config/shared_config.py，存放共享变量：

# config/shared_config.py
BUCKET = "your-bucket-name"

2. 修改config/__init__.py：

# config/__init__.py
from config.shared_config import BUCKET
from config.output_config import output_data

3. 修改config/output_config.py：

# config/output_config.py
from config.shared_config import BUCKET

def output_data():
    # 直接使用BUCKET即可
    print(f"Using bucket: {BUCKET}")

这样所有模块都依赖独立的共享配置模块，互相之间不再有循环引用，结构更清晰，也便于后续维护。

方案3：调整__init__.py的导入顺序（不推荐，脆弱）

如果你不想改动现有模块结构，也可以尝试调整代码顺序，先定义变量再导入依赖：

# config/__init__.py
# 先定义变量，再导入依赖这个变量的模块
BUCKET = "your-bucket-name"
from config.output_config import output_data

但这种方法非常脆弱——如果后续你在__init__.py里添加了其他依赖output_data的代码，很容易再次触发循环导入问题，只适合临时应急用。

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