Python Virtualenv出现ImportError: No Module named Zroya的原因排查

这种情况大概率是虚拟环境的Python解释器和你用来安装模块的pip不匹配导致的，我给你梳理下常见的原因和对应的解决步骤：

1. 你可能没激活虚拟环境就装了模块 #

很多时候我们会忘记激活virtualenv，直接用系统的pip安装模块，结果模块被装到了系统Python的site-packages里，而不是虚拟环境中。

解决办法：

• 先激活你的虚拟环境：
  • Windows系统：打开命令行，进入虚拟环境所在目录，执行 .\venv\Scripts\activate（把venv换成你自己的虚拟环境名称）
  • Linux/macOS：执行 source venv/bin/activate
    激活成功后，命令行开头会出现(venv)的标识。

2. 混用了系统pip和虚拟环境pip #

即使激活了虚拟环境，有时候也可能因为环境变量的问题，调用到了系统的pip而不是虚拟环境里的。

验证方法：
激活虚拟环境后，分别执行这两个命令，检查路径是否指向虚拟环境目录：

• Windows：where python 和 where pip
• Linux/macOS：which python 和 which pip
  如果输出的路径不是你虚拟环境文件夹下的可执行文件，说明环境变量有问题。

解决办法：
激活虚拟环境后，直接用python -m pip install zroya来安装模块，这种方式会强制使用当前Python解释器对应的pip，避免路径混淆。

3. 检查虚拟环境的site-packages目录 #

手动确认模块是否真的装到了虚拟环境里：
找到你的虚拟环境文件夹，进入Lib\site-packages（Windows）或者lib/python3.4/site-packages（Linux/macOS），看看有没有zroya相关的文件夹或者.egg文件。如果没有，说明安装没成功，重新执行安装命令。

4. IDE解释器配置问题（如果用IDE运行脚本） #

如果你是用PyCharm、VS Code等IDE运行脚本，可能IDE默认使用的是系统Python解释器，而不是虚拟环境里的。

解决办法：
在IDE的设置里找到Python解释器选项，切换到你创建的虚拟环境对应的Python.exe（Windows）或者Python可执行文件（Linux/macOS）。

最后验证 #

激活虚拟环境后，执行这条命令：

python -c "import zroya; print(zroya.__file__)"

如果能成功输出模块的路径，且路径在你的虚拟环境目录下，说明问题解决了，再运行你的脚本应该就不会报错了。

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