Ubuntu环境下mplsoccer已安装仍报ModuleNotFoundError问题求助

1. 核对Python解释器路径一致性 #

• 先在终端执行which python和which python3，确认系统默认的Python版本路径。
• 打开PyCharm的File > Settings > Project: [你的项目名] > Python Interpreter，查看当前项目使用的解释器路径，和终端输出的路径做对比。
• 若路径不一致，要么把PyCharm的解释器切换为终端用的版本，要么用项目解释器对应的命令重新安装：

  # 比如项目用的是python3.9，就运行
  python3.9 -m pip install mplsoccer
  

2. 检查虚拟环境激活状态 #

• 如果你用了virtualenv/venv这类虚拟环境，确认编辑器是否绑定了正确的虚拟环境：
  • VSCode可以点击左下角的Python版本选择器，切换到目标虚拟环境的解释器。
  • 终端运行代码前，先激活虚拟环境再重装模块：

    source 你的虚拟环境目录/bin/activate
    pip install mplsoccer
    

3. 强制重装并验证模块可用性 #

• 在终端用对应Python解释器强制重装：

  python3 -m pip install --force-reinstall mplsoccer
  

• 安装完成后，直接在终端验证模块是否能正常导入：

  python3 -c "import mplsoccer; print(mplsoccer.__version__)"
  

  要是能输出版本号，说明模块本身安装没问题，问题出在编辑器的解释器配置。

4. VSCode额外配置检查 #

• 打开VSCode命令面板（Ctrl+Shift+P），输入Python: Select Interpreter，选择刚才终端验证成功的那个解释器。
• 查看项目根目录下的.vscode/settings.json，确认python.defaultInterpreterPath是否指向正确的解释器路径。

5. 权限与路径排查 #

• 如果之前用sudo pip install安装，模块可能在系统级目录，编辑器的用户级解释器访问不到，改用--user参数重装：

  python3 -m pip install --user mplsoccer
  

• 查看mplsoccer的安装位置：

  python3 -m pip show mplsoccer
  

  把输出里的Location路径，和Python的搜索路径做对比：

  python3 -c "import sys; print(sys.path)"
  

  要是安装路径不在搜索列表里，可以在代码开头手动添加：

  import sys
  sys.path.append("mplsoccer的完整安装路径")
  

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