PyCharm导入stub文件报错ModuleNotFoundError: No module named 'stubs.profiler'求助

检查目录结构与包标识 #

• 确保stubs目录下存在__init__.py文件（空文件即可），让Python将该目录识别为可导入的包。如果没有，直接在stubs文件夹内新建空的__init__.py。
• 核对文件层级：确认stubs目录与profiler.py的位置关系，只有当两者处于同一父目录下时，import stubs.profiler的路径才有效。

配置PyCharm源代码根目录 #

• 在PyCharm中右键点击code目录（或包含stubs的上级目录），选择Mark Directory as -> Sources Root。这会让PyCharm将该目录加入Python的模块搜索路径，确保解释器能找到stubs模块。

验证Python解释器配置 #

• 打开PyCharm的File -> Settings -> Project: [你的项目名] -> Python Interpreter，确认当前使用的解释器是项目对应的虚拟环境或全局环境，避免因环境不一致导致路径识别错误。

调整导入方式（可选） #

• 如果是为profiler.py添加类型提示，可直接将存根文件命名为profiler.pyi并放在profiler.py同一目录下，Python会自动关联存根信息，无需单独创建stubs文件夹，导入时直接使用import profiler即可读取类型定义。

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