拆分Python模块执行代码后，如何从__main__.py访问__init__.py符号？

你遇到的问题其实是Python模块导入机制的常见场景：当直接运行__main__.py作为脚本时，Python不会自动把它的父目录加入模块搜索路径，导致无法直接导入同目录的foo模块（也就是__init__.py）。下面给你几种更优雅且安全的解决方案：

方案1：使用importlib直接加载同目录的__init__.py #

这种方法不依赖路径修改，直接定位并加载当前目录的__init__.py作为foo模块，完全避免导入其他位置的同名模块：

# __main__.py中的代码
import importlib.util
import os
import sys

# 定位同目录的__init__.py文件
init_file_path = os.path.join(os.path.dirname(__file__), "__init__.py")
# 创建模块规格
spec = importlib.util.spec_from_file_location("foo", init_file_path)
# 加载模块
foo_module = importlib.util.module_from_spec(spec)
# 将模块注册到sys.modules，确保后续导入也能使用
sys.modules["foo"] = foo_module
# 执行模块内容
spec.loader.exec_module(foo_module)

# 现在可以正常使用foo模块里的内容了
foo_module.bar("fritz")

这个方案的优势是绝对可靠，不管你是直接运行__main__.py，还是用python -m foo调用，都能准确加载当前目录的foo模块，不会受Python路径的影响。

方案2：修改IDE的运行工作目录 #

如果你的主要场景是在IDE中调试，最优雅的方式是修改IDE的运行配置，把工作目录设置为项目根目录my_project，而不是foo目录。

比如在PyCharm/VS Code中：

• 找到__main__.py的运行配置
• 将Working Directory设置为my_project的绝对路径

这样修改后，你可以直接在__main__.py中写：

import foo

foo.bar("fritz")

因为此时项目根目录my_project在Python的搜索路径中，foo作为子模块可以被正常导入，同时python -m foo的调用方式也不受影响。

方案3：安全修改sys.path（比你原来的方法更可靠） #

如果你不想用importlib，也可以修改sys.path，但要确保优先导入当前目录的foo模块，而不是其他位置的同名模块：

# __main__.py中的代码
import os
import sys

# 获取当前文件的父目录（也就是my_project），并插入到路径最前面
project_root = os.path.dirname(os.path.abspath(__file__))
sys.path.insert(0, project_root)

import foo

foo.bar("fritz")

这里用sys.path.insert(0, ...)代替append，确保项目根目录的优先级最高，这样就不会意外导入site-packages或其他路径下的foo模块，比你原来的方法更安全。

方案4：相对导入（仅适用于python -m foo调用） #

如果你的主要使用方式是python -m foo，而直接运行__main__.py只是偶尔调试，可以用相对导入：

# __main__.py中的代码
from . import bar

bar("fritz")

但要注意：这种方式在直接运行__main__.py时会报错（因为此时它是作为脚本运行，不是foo模块的一部分），只有用python -m foo调用时才能正常工作。

总结一下：如果需要兼顾直接运行脚本和python -m foo调用，方案1或方案3是最优选择；如果主要在IDE中开发，方案2最优雅。

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