如何实现Python包与独立脚本等效运行并解决相对导入错误？

核心问题根源 #

用python do_something.py运行时，脚本是独立顶层脚本，同级的do_something包会被当作普通第三方模块导入；而用python do_something运行包时，整个目录被当作主包模块执行，相对导入的依赖上下文和顶层脚本模式完全不同，这才导致冲突。

方案一：统一用绝对导入（最稳妥） #

把包内所有相对导入改成绝对导入，彻底消除上下文差异：

1. 调整包内模块的导入语句
   比如把things_to_do.py里的from .the_thing import some_func改成from do_something.the_thing import some_func，所有包内的相对导入都替换成以do_something.开头的绝对导入。

2. 统一入口逻辑

   • 保留do_something.py脚本的原有逻辑：

     from do_something import do_it
     
     if __name__ == "__main__":
         do_it()
     

   • 在do_something包内创建__main__.py，内容和上面的脚本完全一致：

     from do_something import do_it
     
     if __name__ == "__main__":
         do_it()
     

这样两种运行方式都会基于包名做绝对导入，逻辑完全等效，不会出现导入错误。

方案二：保留相对导入，适配包运行上下文 #

如果不想修改包内的相对导入，只需要确保包运行时的导入逻辑符合相对导入规则：

1. 确保包的__init__.py正常导出do_it
   比如do_something/__init__.py里要有：

   from .things_to_do import do_it  # 假设do_it定义在things_to_do.py中
   

2. 编写正确的__main__.py
   不要用绝对导入，而是用相对导入从包内获取do_it：

   from . import do_it
   
   if __name__ == "__main__":
       do_it()
   

3. 不要随意修改sys.path
   之前修改sys.path导致问题，大概率是把do_something目录本身加到了sys.path，破坏了包的结构上下文，直接删掉所有手动修改sys.path的代码即可。

验证目录结构 #

确保你的文件结构是这样的（当前工作目录下）：

├─ do_something.py
└─ do_something/
   ├─ __init__.py
   ├─ __main__.py
   ├─ things_to_do.py
   └─ the_thing.py

之后测试两种命令：

• python do_something.py：正常执行脚本
• python do_something：正常执行包

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