PyCharm中无法导入自定义Python模块问题咨询

这种情况我碰到过好多次，大多是PyCharm的解释器配置或者目录识别的问题，给你几个靠谱的解决步骤，按顺序试应该能搞定：

1. 检查PyCharm使用的Python解释器是否和控制台一致 #

控制台能导入模块，说明你的模块确实在某个解释器的环境里，但PyCharm可能用了另一个解释器：

• 打开PyCharm的设置（快捷键Ctrl+Alt+S，或者顶部菜单栏File > Settings）
• 找到Project: [你的项目名称]下的Python Interpreter
• 看当前选中的解释器路径，然后打开控制台输入which python（Linux/macOS）或者where python（Windows），对比两个路径是否一致
• 如果不一样，点击右上角的齿轮图标，选择Add，然后找到控制台对应的解释器路径添加，或者直接切换到正确的那个解释器

2. 将自定义模块所在目录标记为Sources Root #

如果你的自定义模块是自己写的、没通过pip安装的本地模块，PyCharm可能没把它所在的目录当成源码目录：

• 在PyCharm的Project面板里，找到包含你的自定义模块的父目录
• 右键点击这个目录，选择Mark Directory as > Sources Root
• 这个目录会变成蓝色，PyCharm会自动索引里面的Python文件，之后应该就能识别模块了

3. 清除PyCharm的缓存并重启 #

有时候PyCharm的索引缓存会抽风，导致明明存在的模块识别不了：

• 点击顶部菜单栏的File > Invalidate Caches...
• 在弹出的窗口里选择Invalidate and Restart，让PyCharm重启并重新构建索引
• 重启后很多奇怪的识别问题都会消失

4. 手动添加模块路径到解释器的搜索路径 #

如果你的模块是通过pip安装的，但PyCharm的解释器没找到它，可以手动添加路径：

• 在控制台输入pip show 你的模块名称，找到输出里的Location字段，这就是模块所在的目录
• 回到PyCharm的Python Interpreter设置，点击右上角的齿轮图标选择Show All
• 选中当前使用的解释器，点击右侧的Show paths for the selected interpreter
• 点击+号，把刚才找到的Location路径添加进去，然后点击OK应用设置

另外补充个小提示：如果你用了虚拟环境，一定要确保PyCharm激活的是你安装模块的那个虚拟环境，很多时候问题就出在这儿。

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