GitHub上MQTT simulator安装运行报错求助

核心问题分析 #

你遇到的ModuleNotFoundError: No module named 'paho'本质是依赖包安装路径与运行脚本的Python环境不匹配，加上混用Windows和Linux命令导致虚拟环境管理混乱。

具体修复步骤 #

1. 清理混乱的虚拟环境，重新创建

   • 打开CMD，切换到项目目录：

     cd C:\Users\Me\Desktop\python_project
     

   • 删除旧的venv文件夹（手动删除或执行命令：rmdir /s venv）
   • 用Windows专属命令创建虚拟环境（Windows下Python3.3+默认用python而非python3）：

     python -m venv venv
     

2. 正确激活虚拟环境

   • 在CMD中执行激活命令（这是Windows唯一正确的虚拟环境激活方式，不要用Linux的source命令）：

     .\venv\Scripts\activate
     

   • 确认命令行开头出现(venv)前缀，再进行后续操作。

3. 修复依赖安装警告并重新安装依赖

   • 先安装wheel包消除deprecated警告：

     pip install wheel
     

   • 安装项目依赖：

     pip install -r requirements.txt
     

   • 确保输出显示Successfully installed paho-mqtt-1.5.0，此时依赖会被安装到当前激活的虚拟环境中。

4. 正确运行脚本

   • 在激活的虚拟环境中，用python命令执行主脚本（Windows下无需用python3）：

     python mqtt-simulator/main.py
     

关键注意事项 #

• 绝对不要在Windows系统中使用Linux/macOS的source venv/bin/activate命令，这会直接报错
• 所有依赖安装、脚本运行操作必须在激活的虚拟环境（带(venv)前缀）中进行，否则包会安装到全局Python环境，虚拟环境无法识别
• Windows下Python的调用命令默认是python，只有手动配置别名或特殊安装情况下才用python3

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