Python多文件项目从配置文件导入变量出现导入错误如何解决

• 方案1：补全模块搜索路径
  如果你的主运行脚本和config.py不在同一级目录，Python默认找不到对应文件，在主脚本的最开头（所有导入语句之前）加入以下代码：

import sys
import os
# 此处的相对路径根据主脚本和config.py的位置调整
# 例：主脚本在根目录下的src子文件夹，config.py在根目录，就用../
sys.path.append(os.path.join(os.path.dirname(os.path.abspath(__file__)), "../"))

之后就可以正常用from config import head等语句导入配置变量。

• 方案2：检查包结构规范
  如果你的config.py放在单独的文件夹中，该文件夹必须包含一个空的__init__.py文件，Python才会将该文件夹识别为可导入的模块包，否则会抛出导入失败错误。

• 方案3：确认运行工作目录
  运行脚本时建议cd到项目的根目录（即config.py所在的目录）再执行运行命令，避免工作目录偏移导致的路径识别错误。

• 方案4：排查命名冲突
  检查项目中是否存在和config.py重名的文件/文件夹，或者是否和Python内置的config模块冲突，可以尝试将配置文件重命名为my_config.py后修改导入语句重试。

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