CMD执行pip报错：Python致命错误（bad magic number）及PYTHONHOME异常

核心问题定位 #

从报错信息和描述来看，问题根源是环境变量PYTHONHOME的错误配置：Python 3.10的执行程序被强制指向Spyder内置Python 3.8的核心库路径，导致版本不匹配，触发bad magic number编码初始化错误。

分步解决方案 #

1. 修正PYTHONHOME环境变量 #

• 按下Win+R输入sysdm.cpl，打开系统属性窗口，切换到「高级」选项卡→点击「环境变量」
• 在系统变量列表中找到PYTHONHOME：
  • 若当前值为C:\Program Files\Spyder\Python，直接删除该变量（Spyder内置Python是隔离环境，无需全局设置PYTHONHOME）
  • 若需要全局指定Python版本，可将其设置为目标版本的根目录（比如默认用3.10就设为C:\Python\Python 3.10，但不推荐全局设置，避免后续冲突）
• 同步调整Path变量：将你优先使用的Python版本的根目录和Scripts子目录移到Path列表最顶部（比如想用Spyder的3.8，就把C:\Program Files\Spyder\Python和C:\Program Files\Spyder\Python\Scripts移到最前面）

2. 精准调用对应版本的pip #

如果不想修改全局环境，每次在CMD里直接指定Python路径调用pip，彻底规避版本混淆：

• 给Spyder的Python3.8安装依赖：

  "C:\Program Files\Spyder\Python\python.exe" -m pip install something
  

• 给独立Python3.10安装依赖：

  "C:\Python\Python 3.10\python.exe" -m pip install something
  

3. 清理混乱的PYTHONPATH #

当前PYTHONPATH混入了多版本Python路径（3.7.9、3.10）和非Python相关路径（Chrome驱动、Chrome程序），会加剧路径冲突：

• 在环境变量中找到PYTHONPATH，仅保留必要的项目路径（比如C:\Users\tlc_l\Desktop\Coding perso），删除所有不同Python版本的Lib、site-packages路径
• Spyder的专属路径会由其自身环境自动加载，无需全局添加到PYTHONPATH

4. 验证修复效果 #

修改完成后关闭所有CMD窗口，重新打开执行以下命令确认：

python --version
pip --version

确认版本符合预期后，再测试pip install是否正常运行。

补充说明 #

• bad magic number错误本质是Python执行程序与核心库版本不兼容，这里并非单个字节码文件缓存问题；若后续遇到单个脚本触发该错误，可删除对应.pyc文件解决
• Spyder内置Python是独立隔离环境，建议直接使用Spyder内置终端安装依赖，从根源避免全局环境冲突

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