Python模块化代码中全局常量的定义与跨模块访问问题

你现在遇到的问题很典型——在main.py里定义了VERBOSE和SAMPLINGRATE这类全局常量，但模块（比如module1、module2）里直接调用会因为作用域问题报错。下面给你几种实用的解决办法，每种都配了代码示例，你可以根据自己的项目需求选择：

1. 单独创建配置模块（最推荐） #

这是Python项目里管理全局常量的标准做法，把所有常量集中放到一个专门的配置文件里，所有模块都从这里导入，不仅结构清晰，还能避免循环导入的坑。

步骤： #

• 新建config.py文件，专门存放常量：

# config.py
VERBOSE = True
SAMPLINGRATE = 44100

• 修改main.py，从配置模块导入常量：

# main.py
import numpy
from config import VERBOSE, SAMPLINGRATE
from module1 import Class1
from module2 import Class2

items1 = []
items2 = []
for i in range(100):
    items1.append(Class1(i))
    items2.append(Class2(i))

• 在module1.py里导入配置模块的常量使用：

# module1.py
import numpy
from config import VERBOSE, SAMPLINGRATE

class Class1:
    def __init__(self, i):
        self.i = i
        # 其他初始化逻辑

    def dosomething(self):
        # 业务逻辑
        if VERBOSE:
            print(f"当前采样率：{SAMPLINGRATE}，Class1的dosomething方法已执行")

这种方式的好处是：所有常量统一管理，后续修改只需要改config.py，模块间没有耦合，完全不用担心循环导入的问题。

2. 实例化类时传递常量 #

如果你的常量需要根据不同实例动态调整，或者不想依赖全局配置，那可以在创建类的实例时把常量作为参数传进去。

修改后的代码： #

• main.py：

# main.py
VERBOSE = True
SAMPLINGRATE = 44100
import numpy
from module1 import Class1
from module2 import Class2

items1 = []
items2 = []
for i in range(100):
    # 实例化时传入常量
    items1.append(Class1(i, verbose=VERBOSE, sampling_rate=SAMPLINGRATE))
    items2.append(Class2(i, verbose=VERBOSE, sampling_rate=SAMPLINGRATE))

• module1.py：

# module1.py
import numpy

class Class1:
    def __init__(self, i, verbose, sampling_rate):
        self.i = i
        # 把常量存为实例属性
        self.verbose = verbose
        self.sampling_rate = sampling_rate

    def dosomething(self):
        # 使用实例属性里的常量
        if self.verbose:
            print(f"当前采样率：{self.sampling_rate}，Class1的dosomething方法已执行")

这种方式的优势是耦合度极低，每个实例可以拥有独立的配置值，适合需要灵活调整的场景。

3. 直接从main模块导入常量（需谨慎） #

如果不想额外创建配置模块，也可以直接从main模块导入常量，但要注意循环导入的问题——只要模块里不反向导入main里的其他内容，就不会出问题。

修改后的module1.py： #

# module1.py
import numpy
# 直接导入main模块
import main

class Class1:
    def __init__(self, i):
        self.i = i

    def dosomething(self):
        # 通过main.前缀访问常量
        if main.VERBOSE:
            print(f"当前采样率：{main.SAMPLINGRATE}，Class1的dosomething方法已执行")

注意：你的main.py里必须先定义常量，再导入模块（就像你现在的代码顺序一样），这样模块导入main时，常量已经被定义了，不会报错。但如果后续模块里又导入了main的其他类或函数，很容易触发循环导入，导致程序崩溃，所以这个方法只适合小型项目临时用。

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