如何在作为包运行或单独运行时实现Python相对导入？

直接运行python -i my_module.py时，文件会被当作顶级脚本而非包的一部分，导致相对导入语法失效。以下是几种比try-except更优雅的解决方案：

方案一：使用-m参数以模块方式运行（推荐） #

Python的-m参数会将指定模块当作包的一部分加载，天然支持相对导入，同时结合-i参数可进入交互调试模式。

假设你的包结构如下：

my_package/
    __init__.py
    my_module.py
    other_module.py

直接执行以下命令即可：

python -m my_package.my_module -i

这种方式完全符合Python模块系统的设计规范，无需修改任何代码。

方案二：修改模块的__package__属性 #

如果必须直接运行my_module.py文件，可以在文件开头添加一段代码，将其标记为包的一部分：

if __name__ == "__main__" and __package__ is None:
    import sys
    from pathlib import Path
    # 将包的父目录添加到sys.path（确保Python能找到包）
    sys.path.insert(0, str(Path(__file__).parent.parent))
    # 设置当前模块所属的包名
    __package__ = "my_package"

# 之后正常使用相对导入
from .other_module import x, y

这样直接运行文件时，Python会识别它为包内模块，相对导入即可正常工作。

方案三：改用绝对导入替代相对导入 #

将相对导入替换为基于包名的绝对导入，同时确保包所在目录在sys.path中：

if __name__ == "__main__":
    import sys
    from pathlib import Path
    # 将包的父目录加入sys.path
    sys.path.insert(0, str(Path(__file__).parent.parent))

# 使用绝对导入
from my_package.other_module import x, y

绝对导入在大型项目中可读性更强，避免了相对导入的层级依赖问题，也能兼容两种运行场景。

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