You need to enable JavaScript to run this app. 为什么我无法将自定义Python模块导入到自有代码中
优惠活动
大模型
产品
解决方案
定价
更多

为什么我无法将自定义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.

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 11:27:05