导入模块时出现ModuleNotFoundError问题求助
2026-8-8
问题解决与优化方案
错误原因与修复方法
你的问题出在module1.py中的导入方式不规范：
当单独运行module1.py时，Python会自动把当前所在的package1目录加入sys.path，所以import subpackage1能找到子包；但从main.py运行时，sys.path的根目录是projectfolder，subpackage1并非顶层包，自然无法被识别。
修复选以下任意一种方式即可：
- 相对导入：将module1.py中的
import subpackage1改为from . import subpackage1，这里的.代表当前所在的package1包，无论从哪个入口运行都能正确定位子包。 - 绝对导入：改为
from package1 import subpackage1，这种方式基于顶层包名称导入，只要projectfolder在sys.path中（直接运行main.py时默认满足），就能正常导入。
更优的包与模块组织方式
- 精简
__init__.py：只在初始化文件中导出对外需要的接口，比如你当前package1/__init__.py只导入function2、subpackage1/__init__.py只导入function1的做法是合理的，避免把无关导入堆在初始化文件里，减少冗余和循环导入风险。 - 优先使用绝对导入：跨包导入时用顶层包开头的绝对路径（比如
from package1.subpackage1 import function1），代码可读性更强，也不容易因运行目录变化出问题。 - 统一入口运行：避免直接运行单个模块文件（比如单独跑module1.py），始终通过main.py作为入口，保持导入逻辑一致，减少调试时的环境差异问题。
- 按需拆分层级：如果当前文件数量极少，没必要过度分层，比如
subpackage1只有一个module2.py时，可直接将module2.py放在package1下；若后续功能会扩展，提前分层则更利于维护。 - 适配现代项目结构：若后续项目规模变大，建议添加
pyproject.toml配置文件，将项目声明为可安装包，导入逻辑会更规范，也方便用pip管理依赖。
内容的提问来源于stack exchange，提问作者a_floating_point
相关产品推荐
相关产品推荐
