树莓派Python venv虚拟环境已安装模块无法导入问题咨询

Python 内置venv创建的虚拟环境，依赖隔离逻辑仅在虚拟环境激活状态下生效。执行deactivate退出虚拟环境后，终端会自动切回全局系统的Python解释器环境，你在虚拟环境里安装的mutagen等第三方包没有装到全局环境，自然会触发模块找不到的报错。
你观察到的pygame、pillow可正常导入、os/random等标准库可正常导入的现象，完全符合这个逻辑：这两个第三方库是系统全局Python环境预装的，标准库本身随Python自带，不需要额外安装，所以不受虚拟环境退出的影响。

• 方法1：激活虚拟环境后再运行脚本
  这是最符合venv设计逻辑的常规用法，每次运行项目代码前，先在项目目录执行激活命令，等终端提示符前出现(venv)标识，就说明已经进入虚拟环境，此时运行脚本会自动加载虚拟环境内的所有依赖：

  cd ~/Desktop/Project
  source venv/bin/activate
  # 激活后正常运行脚本即可
  python3 test.py
  

  后续不需要使用虚拟环境时，再执行deactivate退出即可。
• 方法2：直接调用虚拟环境内的解释器运行脚本
  如果不想每次手动激活，可以直接指定虚拟环境目录下的Python解释器绝对路径运行脚本，不需要提前激活，解释器会自动识别同虚拟环境下安装的所有依赖，适合写定时任务、开机自启脚本的场景：

  # 项目目录下直接执行，路径替换成你自己的venv路径即可
  /home/millertime/Desktop/Project/venv/bin/python3 test.py
  

• 方法3：配置代码编辑器/IDE的解释器路径
  如果你是在VS Code、Thonny等图形化编辑器里点击运行按钮触发的报错，直接打开编辑器的Python解释器设置项，选中项目目录下venv/bin/python3作为默认解释器，后续点击运行时编辑器会自动调用虚拟环境的依赖，不需要手动执行终端激活命令。

注意避坑：激活虚拟环境后不要加sudo执行pip安装或python运行命令，sudo会强制重置环境变量，实际调用的是全局root权限下的Python解释器，安装的包不会进入你的虚拟环境，还可能打乱全局依赖。

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