树莓派升级Python 3.9后找不到pygame模块该如何解决

问题根因 #

Python不同版本的第三方包安装路径相互独立，你此前为Python 3.4.2安装的pygame默认不会被Python 3.9.0识别，属于多版本环境下的正常情况。

方案1：为Python 3.9.0单独安装pygame（推荐，兼容性最好） #

• 首先确认Python 3.9对应的pip工具，树莓派环境下通常为pip3.9，执行命令验证关联关系：
  pip3.9 -V
  输出结果需明确显示关联的是Python 3.9.0的安装路径。
• 执行对应pip命令安装pygame：
  pip3.9 install pygame
• 安装完成后验证导入状态：
  python3.9 -c "import pygame; print(pygame.__version__)"
  正常输出版本号即表示配置完成。

方案2：手动指定现有pygame路径（无需重新安装） #

如果你确认现有pygame版本兼容Python 3.9.0，可通过修改模块搜索路径实现识别，分两种生效方式：

临时生效（仅当前运行的脚本有效） #

在你需要运行的Python代码最开头添加以下内容，替换为你已知的pygame存放路径：

import sys
# 替换引号内的内容为你的pygame实际存放路径
sys.path.append("/your/actual/pygame/path")
import pygame

永久生效（所有Python 3.9.0运行环境生效） #

• 先查询Python 3.9.0的用户站点包路径：
  python3.9 -m site --user-site
• 进入上述输出的路径，新建后缀为.pth的配置文件，例如custom_pkgs.pth
• 在该文件内写入你已知的pygame存放路径，仅需一行路径文本
• 保存退出后重启Python 3.9.0运行环境即可生效

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