Python如何导入外部目录文件中的函数及ImportError报错解决
报错原因解析
先修正你提供的目录结构排版错位问题,实际逻辑层级如下:
├── apps │ ├── package1 │ ├── directory 1 │ │ ├── demo1.py │ │ └── demo2.py │ ├── test1.py │ └── test2.py(内部定义了function2函数)
你在demo2.py中写的from test2 import function2触发ImportError,核心原因有两个:
- Python执行demo2.py时,默认的模块搜索路径仅包含demo2.py所在的「directory 1」文件夹,不会自动向上遍历到apps层级的test2.py位置,此时Python根本无法定位到目标test2.py模块,自然无法导入内部的function2。
- 如果环境中其他路径存在同名的test2.py文件,Python优先搜到了错误位置的同名文件,也会因为文件内没有定义function2触发同类报错。
可落地的解决方法
方法1:规范包结构导入(生产环境推荐)
- 在apps目录、directory 1目录下分别新建空的
__init__.py文件,将两个目录标记为Python可识别的包 - 运行时将apps的上一级目录作为项目工作根路径,不要直接进入directory 1文件夹启动demo2.py
- 将demo2.py内的导入语句修改为:
from apps.test2 import function2 - 启动命令使用模块执行模式:
python -m apps.directory 1.demo2,注意目录名带空格,执行时如果出现路径解析报错,可给模块路径加双引号,避免直接执行脚本带来的路径偏移问题。
方法2:临时适配搜索路径(本地调试场景适用)
如果不想调整现有包结构,可以直接在demo2.py的导入逻辑前,手动将apps目录加入Python的全局模块搜索路径,示例代码:
import sys import os # 获取当前demo2.py的绝对路径 current_file_path = os.path.abspath(__file__) # 拿到demo2.py所在的directory 1的目录路径 current_dir = os.path.dirname(current_file_path) # 向上跳一级,获取apps目录的绝对路径 apps_root_dir = os.path.dirname(current_dir) # 将apps目录加入搜索路径,避免重复添加 if apps_root_dir not in sys.path: sys.path.append(apps_root_dir) # 路径添加完成后,即可正常导入目标函数 from test2 import function2
这个方式不受启动路径影响,只要目录层级没变动,不管从哪个位置启动demo2.py都能正常完成导入。
常见排查点
如果调整完路径还是触发同类报错,依次检查:
- 确认test2.py实际存放位置和预期一致,没有被误移动到其他目录
- 全局检查项目内是否存在其他同名test2.py文件,避免Python优先匹配到错误路径的同名文件
- 确认test2.py内的function2定义没有被包裹在
if __name__ == "__main__":这类条件执行块内,避免导入时函数定义逻辑没有被执行
内容的提问来源于stack exchange,提问作者Sri hari
相关产品推荐
相关产品推荐

