导入整个Python包后无法找到内部模块的问题排查

这个问题的核心原因很简单：你的tools包的__init__.py文件没有把A和B模块暴露到包的顶层命名空间里。

为什么会出现这种差异？ #

Python处理包导入的逻辑是这样的：

• 当你执行import tools时，Python会加载并执行tools/tools/__init__.py文件，然后把这个文件里定义的所有名字（变量、导入的模块/类/函数等）放到tools这个包的命名空间中。你用cookiecutter-pypackage模板生成的包，默认的__init__.py通常是空的，或者只包含版本号这类元信息，根本没有导入A和B模块。这就导致import tools之后，tools的命名空间里只有那些默认的包属性（就是你用dir(tools)看到的__builtins__、__path__这些），自然找不到A和B。
• 而from tools import A, B能正常工作，是因为这种导入方式会直接去tools包的目录下查找对应的A.py和B.py文件——只要模块文件存在，Python就能找到它并导入，完全不需要依赖__init__.py里的导入语句。

解决办法 #

有两种常见的方式让你在import tools后能顺畅访问到A和B：

1. 在__init__.py中显式导入模块

直接在tools/tools/__init__.py里添加导入语句，把模块拉到包的顶层命名空间：

# 导入整个模块，之后可以用 tools.A、tools.B 访问
from . import A
from . import B

# 如果你想直接暴露模块里的特定类/函数（比如A.py里有MyClass），也可以这么写
# from .A import MyClass
# from .B import my_function

这样修改后，再执行import tools，dir(tools)里就会出现A、B（或者你导入的类/函数），直接通过tools.A就能访问模块内容了。

2. 使用__all__变量（辅助优化）

在__init__.py里定义__all__列表，它主要用来控制from tools import *时会导入哪些模块：

__all__ = ['A', 'B']

不过要注意：__all__不会自动把模块添加到tools的命名空间里——也就是说，只加__all__的话，import tools后你还是得用tools.A才能访问，而不是直接调用。它的作用是让from tools import *能一次性导入指定的模块，避免导入无关内容。如果想让import tools后直接能访问模块，还是得配合第一种方法的显式导入。

总结 #

你的问题本质是包的命名空间管理问题，通过修改__init__.py来显式导入需要的模块，就能让这些模块出现在包的顶层命名空间里，解决import tools后找不到模块的问题。

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