Python导入优先级问题：本地config包被第三方包覆盖如何处理

你遇到的问题核心是本地config包与第三方包的config.py重名，且第三方config模块已经被导入缓存，或是你的路径调整时机不对导致未生效，可通过以下方案解决：

方案1：调整导入顺序+清理模块缓存（无需修改utils.py代码） #

在my_script.py的最开头（任何其他导入语句之前）添加如下代码：

import sys
import os

# 生成项目根目录的绝对路径，避免相对路径受工作目录影响
project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
# 插入到sys.path最靠前的位置，优先级最高
if project_root not in sys.path:
    sys.path.insert(0, project_root)

# 清理已经被缓存的第三方config模块，强制重新走路径查找
if "config" in sys.modules:
    del sys.modules["config"]

# 再导入你的utils模块
from common import utils

该方案可以保证Python优先查找你本地项目下的config包。

方案2：改用相对导入（推荐，从根源避免冲突） #

直接修改common/utils.py里的导入语句，使用包内相对导入，完全避开全局模块名的冲突：

# 从当前common包的上级目录找config包
from ..config.config import SOME_VALUE

这种写法不需要调整sys.path，只要你的项目结构是标准包结构就可以正常运行。

方案3：重命名本地config包（一劳永逸，适合长期维护的项目） #

将你本地的config文件夹改名为my_config（或者其他不会和第三方包重名的名称），同步修改utils.py里的导入语句：

from my_config.config import SOME_VALUE

同时修改my_script.py里的路径导入逻辑即可，彻底避免后续出现同类命名冲突问题。

方案4：临时修改PYTHONPATH环境变量（无需修改代码） #

运行脚本前手动将项目根目录加到PYTHONPATH的最前面，优先查找本地模块：

• Linux/Mac 终端运行：

PYTHONPATH=/home/myuser/my_repo:$PYTHONPATH python main/my_script.py

• Windows 命令行运行：

set PYTHONPATH=C:\path\to\my_repo;%PYTHONPATH%
python main\my_script.py

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