Python项目内与跨项目共享常量的Pythonic实现方法

一、同一项目内的错误修复与规范写法 #

你当前报错的核心原因：导入constants模块后，直接使用WIDTH无法识别——常量属于constants模块的属性，必须通过模块名访问，或明确导入指定常量。

正确写法1：通过模块名访问 #

# main.py
import constants

print(constants.WIDTH)

正确写法2：直接导入指定常量 #

如果不想每次都写模块名，可以精准导入需要的常量：

# main.py
from constants import WIDTH

print(WIDTH)

需导入多个常量时，用逗号分隔即可：from constants import WIDTH, HEIGHT, MAX_VALUE。

注意：不推荐使用from constants import *，这种写法会污染命名空间，容易引发命名冲突，不符合PEP8规范。

二、跨项目共享常量（避免复制文件） #

如果两个独立项目需要共用这套常量，无需复制文件，以下三种方案均可：

方案1：将常量目录添加到Python路径 #

在需要导入常量的项目代码中，先把constants.py所在的目录添加到Python的sys.path（Python会在该列表内查找模块）：

# 目标项目的入口文件
import sys
import os

# 替换为你的constants.py所在的绝对路径，用os.path处理可适配不同系统路径分隔符
constants_dir = os.path.dirname(os.path.abspath("/path/to/your/constants.py"))
sys.path.append(constants_dir)

# 之后即可正常导入
import constants
print(constants.WIDTH)

若PyCharm提示未解析引用，右键点击constants.py所在目录，选择Mark Directory as > Sources Root，IDE即可识别该目录下的模块。

方案2：打包成可安装的Python包（最规范） #

把常量所在目录做成可安装的Python包，步骤如下：

1. 在constants.py所在目录下创建setup.py（或用pyproject.toml配合Poetry）
2. 执行pip install -e .（开发模式安装，修改常量后无需重新安装）
3. 两个项目均安装该包，之后即可像导入标准库一样直接import constants。

方案3：使用软链接（适合临时共享） #

在目标项目目录下，创建指向constants.py的软链接：

• Linux/macOS终端：ln -s /path/to/your/constants.py ./constants.py
• Windows命令提示符（需管理员权限）：mklink constants.py C:\path\to\your\constants.py
  创建完成后，目标项目可像使用本地文件一样导入constants，但需注意软链接的跨系统兼容性，PyCharm可能需要刷新目录才能识别。

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