PyCharm中如何将utils目录作为模块导入并保留命名空间

可行操作步骤 #

• 打开PyCharm的File → Settings（Windows/Linux）或PyCharm → Settings（Mac）
• 进入Project: project1 → Python Interpreter，点击右上角齿轮图标，选择Show All
• 在弹出的窗口中选中当前使用的解释器，点击右下角的「显示所选解释器的路径」图标（文件夹样式）
• 点击+号，添加all_code_root目录的完整绝对路径（注意是all_code_root，不是utils目录本身）
• 依次点击OK保存设置，执行File → Invalidate Caches...并重启PyCharm

导入验证 #

回到app1.py中，直接使用from utils import some_specific_util即可正常导入，PyCharm会正确识别utils作为顶层模块。

原理说明 #

将all_code_root添加到Python解释器的搜索路径后，Python会在该目录下扫描可导入的模块。由于utils目录下已存在__init__.py，会被识别为一个顶层模块，因此支持from utils import...的导入语法。这种方式无需创建all_code_root级别的项目，也不需要修改utils的目录结构，完全符合你的需求。

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