Atom编辑器运行Python项目提示Module Not Found错误如何解决？

问题根源 #

你遇到的报错本质是Atom调用的Python解释器路径，和执行pip install命令时的Python解释器路径不匹配：全局安装的包存放在pip对应解释器的site-packages目录下，但Atom运行代码时调用的是另一个解释器，它的模块搜索路径里没有对应包的存放位置，所以会提示找不到模块。

解决步骤 #

1. 绑定pip与Python解释器 #

避免pip对应版本和使用的Python版本不一致，安装依赖时统一使用以下命令，保证包安装到当前Python解释器的对应目录中：

python3 -m pip install 包名

Windows用户如果用的是Python3，可以把命令中的python3替换为py -3或者你的Python启动命令。

2. 配置Atom的Python解释器路径 #

根据你使用的Atom运行插件调整配置：

• 如果用script插件运行代码：
  • 打开Atom设置 → 进入Packages页 → 搜索找到script插件 → 点击设置
  • 找到Python Command配置项，填入你常用的Python解释器完整路径（可以在终端执行which python3<Mac/Linux>或where python查看路径），保存后重启Atom生效。
• 如果用ide-python插件：
  • 进入插件设置页，找到Python Executable配置项，填入对应Python解释器路径即可。

3. 用虚拟环境规范依赖管理（推荐） #

既可以避免全局依赖冲突，也不会导致项目根目录杂乱：

• 进入项目根目录，执行命令创建虚拟环境：

  python3 -m venv venv
  

• 激活虚拟环境：
  • Mac/Linux：source venv/bin/activate
  • Windows：venv\Scripts\activate
• 激活后正常执行pip install 包名安装依赖，所有依赖都会存放在项目下的venv目录中，不会污染根目录
• 把Atom的Python解释器路径配置为项目venv目录下的Python路径，即可正常导入安装的包。

排查技巧 #

如果调整后仍然报错，可以在代码开头加入以下内容，确认当前运行环境的信息：

import sys
# 打印当前使用的Python解释器路径，确认和你配置的路径一致
print(sys.executable)
# 打印当前解释器的模块搜索路径，确认包所在的site-packages目录是否在列表中
print(sys.path)

如果包的存放路径不在sys.path中，可以临时添加：

import sys
sys.path.append("你的site-packages目录完整路径")

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