Python 3相对导入在本地与K8s环境下的兼容问题求助

核心矛盾很明确：你直接用python <filename>.py运行脚本时，Python会把该脚本当作独立的顶级脚本而非包的一部分，导致相对导入（带.的写法）报错；而K8s环境是将代码作为包的一部分启动，相对导入有效，但绝对导入又因环境变量差异找不到模块。以下是几种靠谱的兼容方案：

方案1：统一用相对导入，本地改用模块方式启动 #

保持module1.py里的相对导入写法：

from .module2 import MySymbol

本地运行时，不要直接执行脚本，而是从project目录下以模块方式启动：

python -m src.package.module1

这种方式会将src视为包的根目录，和K8s的运行逻辑完全一致，相对导入就能正常工作。

方案2：通过设置PYTHONPATH统一绝对导入 #

将project目录添加到PYTHONPATH环境变量中：

• Linux/macOS终端临时设置：

export PYTHONPATH=/path/to/project:$PYTHONPATH

• Windows cmd临时设置：

set PYTHONPATH=C:\path\to\project;%PYTHONPATH%

之后无论在哪个目录，都可以使用绝对导入写法：

from src.package.module2 import MySymbol

K8s容器中也可通过Dockerfile或部署配置添加相同的PYTHONPATH设置，确保两边环境一致。

方案3：兼容式导入（应急用，不推荐长期维护） #

如果暂时无法修改启动方式，可以在module1.py中添加兼容逻辑，先尝试相对导入，失败则切换到绝对导入：

try:
    from .module2 import MySymbol
except ImportError:
    from src.package.module2 import MySymbol

这种方式能临时解决问题，但会增加代码复杂度，长期维护建议优先使用前两种方案。

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