Python模块导入形式咨询及Docker部署模块引用报错排查

核心原理：Python模块导入的本质 #

Python找模块全看sys.path这个列表——导入时会遍历列表里的所有目录，寻找匹配的包或模块：

• __init__.py只是标记文件夹为Python包，但不直接决定能否被找到，关键还是看包所在的目录在不在sys.path里。
• 直接运行.py文件时，该文件所在的目录会被自动加到sys.path最前面；用python -m 模块名运行时，当前工作目录会被加到sys.path里，同时脚本会被当作包的一部分加载，支持相对导入。

你的Docker报错原因 #

你在Docker里大概率是直接运行app/module1/file1.py（比如cd app && python module1/file1.py），这时候sys.path里只有app/module1目录，而module2在app目录下——sys.path里没有app，自然找不到module2。
本地能成功，要么是你在app的父目录下运行脚本，要么IDE自动把app目录加入了sys.path，所以Python能定位到module2。

解决方案 #

方案1：绝对导入+调整sys.path #

在module1/file1.py里用基于app包的绝对导入：

from app.module2.file1 import function

然后在Docker里二选一：

• 把app的父目录加入PYTHONPATH：比如在Dockerfile中添加ENV PYTHONPATH="/app_parent"（假设app位于/app_parent目录下）；
• 从app的父目录运行脚本：比如cd /app_parent && python -m app.module1.file1。

方案2：相对导入+模块方式运行 #

在module1/file1.py里用相对导入：

from ..module2.file1 import function

注意：相对导入只能在脚本作为包的一部分被加载时使用，不能直接运行file1.py。所以Docker里必须用模块方式启动：

cd /app_parent && python -m app.module1.file1

方案3：调整Docker工作目录 #

把Docker的工作目录设为app的父目录，然后用模块方式启动脚本。这样Python会自动把父目录加入sys.path，不管用绝对还是相对导入都能正常工作。

内容的提问来源于stack exchange，提问作者Bruno Henrique Peixoto