如何直接从Python包导入类？自定义包导入报错求助

我完全懂你现在的烦恼——每次写冗长的导入路径太繁琐，还碰到了导入报错的问题，咱们一步步把这个事儿搞定：

第一步：先确认标准的包目录结构 #

首先得把基础的目录结构捋对，这是解决导入问题的核心。正常的Python包结构应该是这样（假设你的包名叫proj1）：

你的项目根目录/
├── setup.py
└── proj1/
    ├── __init__.py
    └── file.py  # 你的Proj1类就定义在这里面

如果你的setup.py是和__init__.py、file.py平级的，那这就是问题之一——setup.py必须放在包目录的上层，不能放在包内部。

第二步：修改__init__.py暴露你的类 #

要实现from proj1 import Proj1这种直接导入，关键就是在包的__init__.py里显式导出你的类。打开proj1/__init__.py，添加如下代码：

# 从file模块导入Proj1类，把它暴露给外部调用者
from .file import Proj1

# 要是有多个类需要直接导入，继续加就行
# from .file import Proj2, Proj3

这样一来，其他项目导入你的包时，就能直接从proj1拿到Proj1类了。

第三步：解决运行file.py时的导入错误 #

你提到运行file.py时出现cannot import name 'Proj1'的错误，这大概率是因为你在file.py里尝试了错误的导入方式（比如直接写from proj1 import Proj1）。当你直接运行file.py时，Python会把它当成独立脚本，而不是包的一部分，这时候相对导入逻辑就会失效。

给你两种解决办法：

• 方法一：以包模块的方式运行脚本
  如果你要测试file.py，从项目根目录执行以下命令：

  python -m proj1.file
  

  这样Python会把proj1当成包来处理，导入逻辑就能正常工作了。
• 方法二：用条件判断隔离脚本运行逻辑
  在file.py里，把测试代码放到if __name__ == "__main__"块里，避免直接运行时触发错误导入：

  class Proj1:
      # 你的类业务代码
  
  if __name__ == "__main__":
      # 这里放你直接运行file.py时的测试代码
      test_obj = Proj1()
      # 测试逻辑写在这里
  

第四步：安装你的包（推荐操作） #

为了让其他项目能更顺畅地导入你的包，推荐在开发时用可编辑模式安装：

cd 你的项目根目录
pip install -e .

这样不管你后续修改包的代码，其他项目都能实时获取最新版本，导入路径也会完全符合预期。

做完这些步骤后，你就能在其他项目里直接用from proj1 import Proj1导入类，不用再写冗长的路径啦！

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