Python项目中包内模块无法导入同级外部文件的问题

你的问题核心是Python模块查找路径规则导致的：

• 运行file6.py时，当前工作目录是myProject，该目录在Python模块查找路径内，因此能正常导入folder1下的模块。
• 直接运行folder1/file1.py时，当前工作目录是folder1，上层的myProject不在查找路径中，所以找不到file6.py。

以下是几种简便解决办法：

1. 使用相对导入（推荐，符合Python包规范） #

在file1.py中修改导入语句为：

from .. import file6

注意：这种方式仅在folder1被当作包导入时生效，比如从myProject目录下执行python -m folder1.file1，或者在其他模块（如file6.py）中导入file1时有效。如果直接用python folder1/file1.py运行脚本，会报错——因为此时Python不会将folder1识别为包。

2. 动态添加父目录到查找路径（适合直接运行子模块的场景） #

如果需要直接运行file1.py，可在脚本开头添加代码，将myProject目录加入Python的查找路径：

import sys
from pathlib import Path

# 获取当前文件的父目录的父目录（即myProject路径）
sys.path.append(str(Path(__file__).parent.parent))

import file6

这种方法不受运行路径限制，无论从哪里启动file1.py，都能找到file6。

3. 配置PYTHONPATH环境变量（适合长期开发） #

将myProject目录的路径添加到系统PYTHONPATH环境变量中，之后无论在哪个路径下运行Python脚本，都能直接用import file6导入模块。临时设置方式：

• Linux/macOS终端：export PYTHONPATH="/path/to/myProject:$PYTHONPATH"
• Windows cmd：set PYTHONPATH=C:\path\to\myProject;%PYTHONPATH%
• Windows PowerShell：$env:PYTHONPATH = "C:\path\to\myProject;$env:PYTHONPATH"

如果是长期维护的项目，也可以将myProject安装为可编辑包：在myProject目录下执行：

pip install -e .

之后就能用绝对导入，比如from myProject import file6，这种方式最规范，适合多人协作场景。

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