为什么我无法将自定义Python模块导入到自有代码中
1. 文件名命名不符合Python模块识别规则
当前实际文件是直接在Classes目录下创建了名为worksheet.utilities.py的文件,并非按照路径层级创建worksheet子文件夹后存放utilities.py。
Python解释器识别模块路径时会以点作为层级分隔符,后续写的所有形如Classes.worksheet.utilities的导入路径,解释器默认会去寻找Classes/worksheet/utilities.py的结构,和实际存放文件的路径完全不匹配,自然找不到模块。
额外说明:这种在文件名中嵌入额外点的命名方式本身就不符合PEP8规范,很容易造成自己和其他开发者的理解歧义,不推荐使用。
2. 错误使用了相对导入语法
带有..的导入语句属于Python包内的相对导入,这类导入只能在被作为模块加载的代码中使用。main.py是直接运行的主脚本,本身没有所属的上层包上下文,使用..层级的相对导入会直接触发attempted relative import with no known parent package报错。
3. 对导入层级的认知偏差
from Classes import WorkSheetUtilities这类写法,默认Classes包层已经将WorkSheetUtilities类向外暴露。但当前项目结构里,WorkSheetUtilities类是定义在文件内部的,Classes层本身根本没有定义这个类,直接从该层导入必然找不到对应对象。
方式1:保留现有不规范文件名的快速修正方法
如果暂时不想调整文件结构,在main.py中可以直接用对应实际文件路径的绝对导入:
from Classes.worksheet.utilities import WorkSheetUtilities
注意确保运行脚本时,命令行的工作路径为项目根目录(即直接执行python main.py),否则Python的模块搜索路径找不到Classes目录,依然会报导入错误。
方式2:修正为规范Python包结构的长期方案(推荐)
按照Python模块的常规组织逻辑,把现有文件调整为如下结构:
- main.py - Classes - __init__.py (空文件,作用是将Classes标记为可导入的Python包) - worksheet (新建同名文件夹) - __init__.py (空文件) - utilities.py (把WorkSheetUtilities类移动到这个文件中)
调整完成后,在main.py中直接使用绝对导入即可正常加载类:
from Classes.worksheet.utilities import WorkSheetUtilities
如果需要简化多层导入的写法,也可以在Classes/worksheet/__init__.py中提前导入目标类:
# 写在Classes/worksheet/__init__.py里 from .utilities import WorkSheetUtilities
之后就可以在main.py中用更短的路径导入:
from Classes.worksheet import WorkSheetUtilities
内容的提问来源于stack exchange,提问作者Mateusz H.

