Python3导入失败：跨目录模块导入报错及导入机制咨询

架构老林

2026-5-28

嘿，这个问题我太熟了！咱们先从你的场景入手，一步步拆解Python3导入系统的逻辑，你就能明白为啥会出现这种情况了。

首先先明确你的目录结构：

lib/
 dir1/
  __init__.py
  dir2/
   __init__.py
   file1.py
   file2.py
main.py

先说说你遇到的问题根源

当你在dir2目录下直接运行file1.py时，Python会把当前工作目录（也就是dir2/）自动加入到sys.path列表里——这是Python运行顶层脚本时的默认行为。所以file1.py里写import file2时，Python能在当前目录找到file2.py，自然运行正常。

但当你从main.py里执行from dir1.dir2.file1 import *时，情况就变了：此时你是在main.py所在的目录（也就是lib/的同级目录）运行脚本，Python的sys.path里默认包含的是这个根目录，而不是dir2/。这时候file1.py里的import file2会让Python去sys.path里找file2，显然找不到，因为file2在lib/dir1/dir2/里，不在根目录下，所以就抛出了No module named 'file2'的错误。

再聊聊Python3导入系统的核心工作逻辑

要搞懂导入，你得记住这几个关键点：

1. 绝对导入 vs 相对导入

Python3默认推荐使用绝对导入或相对导入，而不是像Python2那样依赖隐式的当前目录导入：

绝对导入：从sys.path里的某个根目录开始，用完整的模块路径导入。比如你可以在file1.py里写from dir1.dir2 import file2，这样Python会从sys.path的根目录（也就是main.py所在目录）开始找dir1→dir2→file2。
相对导入：用.（表示当前模块所在的目录）或..（表示父目录）来指定相对路径。比如在file1.py里写from . import file2，意思是“从当前模块（file1）所在的目录（dir2）里导入file2”，这种方式不依赖sys.path的位置，只看模块之间的相对关系。

2. sys.path是Python的模块查找路径表

Python在导入任何模块时，都会依次遍历sys.path里的所有目录，直到找到目标模块（或抛出找不到的错误）。sys.path默认包含：

你执行python命令时的当前工作目录
Python标准库的安装目录
第三方库的site-packages目录
你通过环境变量PYTHONPATH手动添加的目录

3. 顶层脚本 vs 导入的模块

当你直接运行一个.py文件时（比如python file1.py），这个文件会被当作顶层脚本，Python会把它所在的目录加入sys.path。但如果这个文件是被其他脚本导入的（比如从main.py导入file1），它就变成了一个模块，此时它所在的目录不会自动加入sys.path，导入逻辑会依赖它的模块命名空间（也就是dir1.dir2.file1）来查找其他模块。

解决你问题的具体方案

针对你的场景，有两种简单可靠的解决方式：

方案一：使用相对导入（推荐）

修改file1.py里的导入语句为：

# 导入整个file2模块
from . import file2

# 或者导入file2里的特定对象，比如某个函数
from .file2 import your_function_name

这种方式完全不依赖运行时的工作目录，只看模块之间的相对位置，不管从哪里导入file1都能正常找到file2。

方案二：使用绝对导入

修改file1.py里的导入语句为：

from dir1.dir2 import file2

这种方式要求你的项目根目录（也就是main.py所在的目录）在sys.path里——而你运行main.py时默认已经满足这个条件，所以Python能从根目录开始找到dir1.dir2.file2。

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