ModuleNotFoundError：Python 中没有名为“pygame”的模块

ModuleNotFoundError：Python 中没有名为“pygame”的模块

ModuleNotFoundError: No module named ‘pygame’ in Python

Python “ModuleNotFoundError: No module named ‘pygame’” 出现在我们忘记pygame在导入前安装模块或将其安装在不正确的环境中时。

要解决此错误，请通过运行命令安装模块pip install pygame
。

在项目的根目录中打开终端并安装pygame
模块。

# 👇️ in a virtual environment or using Python 2
pip install pygame

# 👇️ for python 3 (could also be pip3.10 depending on your version)
pip3 install pygame

# 👇️ if you get permissions error
sudo pip3 install pygame
pip install pygame --user

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pygame

# 👇️ for python 3 (could also be pip3.10 depending on your version)
python3 -m pip install pygame

# 👇️ using py alias (Windows)
py -m pip install pygame

# 👇️ alternative for Ubuntu/Debian/Mint
sudo apt-get install python3-pygame

# 👇️ alternative for CentOS/Fedora/Red hat
sudo yum install python3-pygame

# 👇️ alternative for OpenSUSE
sudo zypper install python3-pygame

# 👇️ alternative for Arch/Manjaro
sudo pamac install python-pygame

# 👇️ for Jupyter Notebook
!pip install pygame

安装pygame包后，尝试像这样导入它：

import pygame

print(pygame.__version__)

您可以使用以下命令运行包含的示例之一。

python -m pygame.examples.aliens

python3 -m pygame.examples.aliens

py -m pygame.examples.aliens

出现错误的原因有多种：

1. 没有pygame通过运行安装包pip install pygame。
2. 在与您正在使用的版本不同的 Python 版本中安装包。
3. 全局安装包，而不是在您的虚拟环境中。
4. 您的 IDE 运行的 Python 版本不正确。
5. 命名您的模块pygame.py，这将影响官方模块。
6. 声明一个名为pygamewhich 的变量将隐藏导入的变量。

如果错误仍然存​​在，请获取您的 Python 版本并确保您使用正确的 Python 版本安装包。

python --version

例如，我的 Python 版本是3.10.4，所以我会安装 pygame 包pip3.10 install pygame。

pip3.10 install pygame

# 👇️ if you get permissions error use pip3 (NOT pip3.X)
sudo pip3 install pygame

请注意，版本号对应于我正在使用的版本pip。

pip如果您的计算机上未设置PATH ，请替换pip为
python3 -m pip：

# 👇️ make sure to use your version of Python, e.g. 3.10
python3 -m pip install pygame

如果错误仍然存​​在，请尝试重新启动您的 IDE 和开发服务器/脚本。

检查包是否安装

您可以

通过运行命令检查是否pygame安装了软件包pip show pygame。

# 👇️ check if you have pygame installed
pip show pygame

# 👇️ if you don't have pip set up in PATH
python -m pip show pygame

该pip show pygame命令将声明该包未安装或显示有关该包的一堆信息，包括该包的安装位置。

确保你的 IDE 使用正确的 Python 版本

如果未安装该包，请确保您的 IDE
使用的是正确版本的 Python。

例如，在 VSCode 中，您可以按CTRL + Shift + P或（在 Mac 上为⌘+ Shift+ P
）打开命令面板。

然后在字段中键入“Python 选择解释器”。

然后从下拉菜单中选择正确的 python 版本。

在虚拟环境中安装包

如果您使用的是虚拟环境，请确保您是pygame在虚拟环境中而不是全局安装。

如果您还没有虚拟环境，可以尝试创建一个。

# 👇️ use correct version of Python when creating VENV
python3 -m venv venv

# 👇️ activate on Unix or MacOS
source venv/bin/activate

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ install pygame in virtual environment
pip install pygame

如果该python3 -m venv venv命令不起作用，请尝试以下 2 个命令：

• python -m venv venv
• py -m venv venv

您的虚拟环境将使用用于创建它的 Python 版本。

您也不应该声明一个名为pygameas 的变量，这也会影响原始模块。

尝试重新安装包

如果错误未解决，请尝试卸载该pygame软件包，然后
重新安装。

# 👇️ check if you have pygame installed
pip show pygame

# 👇️ if you don't have pip set up in PATH
python -m pip show pygame

# 👇️ uninstall pygame
pip uninstall pygame

# 👇️ if you don't have pip set up in PATH
python -m pip uninstall pygame

# 👇️ install pygame
pip install pygame

# 👇️ if you don't have pip set up in PATH
python -m pip install pygame

尝试重新启动您的 IDE 和开发服务器/脚本。

也可以尝试升级pygame包的版本。

pip install pygame --upgrade

# 👇️ if you don't have pip set up in PATH
python -m pip install pygame --upgrade

无法从源 Pylance 解析导入“pygame”

pygame当模块未安装或您在 IDE（例如 Visual Studio Code）中选择了不正确的 Python 解释器时，会出现错误“无法从源 Pylance 导入“pygame”” 。

要解决该错误，请pygame在您的 IDE 中安装并选择正确的 Python 解释器。

Import "pygame" could not be resolved from source Pylance(reportMissingModuleSource) [Ln 1, Col 8]

确保在您的 IDE 中选择了正确的 Python 解释器

如果您的机器上安装了多个 Python 版本，您可能使用了不正确的版本安装了pygame包，或者您的 IDE 可能被设置为使用不同的版本。

例如，在 Visual Studio Code 中，您可以：

1. 按CTRL + Shift + P或（在 macOS 上为⌘+ Shift+ P）打开命令面板。

然后在搜索字段中键入“Python 选择解释器” 。

2. 从下拉菜单中选择正确的 python 版本。

如果错误仍然存​​在，请尝试重新启动您的 IDE 和开发服务器/脚本。VSCode 经常出现故障，重启即可解决问题。

如果错误未解决，请尝试使用 Visual Studio Code 终端安装pygame模块。

您可以按键盘上的 CTRL + ` （反引号）打开 Visual Studio 代码终端。

打开终端后，Visual Studio Code 将自动激活您的虚拟环境（如果有的话）。

运行pip install pygame命令。

pip install pygame

如果错误仍然存​​在，请尝试通过指定路径来选择 Python 解释器：

1. 按CTRL + Shift + P或（在 Mac 上为⌘+ Shift+ P）打开命令面板。
2. 在字段中键入“Python 选择解释器” 。

3. 选择“输入解释器路径…”。

4. 单击“查找”。

5. 在打开的窗口中，导航到您的 Python 可执行文件：

• If you have a virtual environment on Windows, click on your venv folder,
  then double-click on the Scripts folder, select the python.exe file and
  then Select interpreter.

• If you have a virtual environment on macOS or Linux, click on your venv
  folder, then double-click on the bin folder, select the python file and
  then Select interpreter.

• If you don’t have a virtual environment, use one of the following commands to
  get your path to your python.exe or python executable, specify the path to
  the file and select the executable.

where python

python -c "import sys; print(sys.executable)"

If the error persists, try restarting your IDE and development server/script.

# Alternatively, use a comment to disable the warning

If none of the suggestions helped, you can use a comment to disable the Pylance
warning in your IDE.

import pygame  # type: ignore

print(pygame)

You simply have to add the # type: ignore command on the same line as the
import statement to disable the check for the specific import.

# Table of Contents

1. Install pygame on Windows
2. Install pygame on macOS or Linux
3. Install pygame in Visual Studio Code
4. Install pygame in PyCharm
5. Install pygame in Anaconda
6. Install pygame in Jupyter Notebook

# Install pygame on Windows

To install the pygame module on Windows:

1. Type CMD in the search bar and open the Command Prompt application.
2. Type pip install pygame and press Enter.

pip install pygame

# 👇️ for Python 3
pip3 install pygame

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pygame

# 👇️ for Python 3
python3 -m pip install pygame

# 👇️ using py alias
py -m pip install pygame

# 👇️ if you get permissions error
pip install pygame --user

You can run one of the included examples with the following command.

python -m pygame.examples.aliens

python3 -m pygame.examples.aliens

py -m pygame.examples.aliens

If the installation command doesn’t succeed, try running CMD as an
administrator.

If you get the error
‘pip’ is not recognized as an internal or external command,
use the python -m command when installing pygame.

python -m pip install pygame

python3 -m pip install pygame

py -m pip install pygame

Alternatively, you can install the pygame module in a virtual environment:

1. Open the root directory of your project.
2. Press Shift and right-click in Explorer.

3. Click on “Open PowerShell window here”.
4. Run the following commands.

# 👇️ might also be: "python3 -m venv venv"
python -m venv venv

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ install pygame in virtual environment
pip install pygame

If the python -m venv venv command doesn’t work, try the following 2 commands:

• python3 -m venv venv
• py -m venv venv.

If you see an error message that
ps1 cannot be loaded because running scripts is disabled on this system,
run the following command, type “yes” when prompted and rerun the activation
command.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

pip show pygame
pip3 show pygame

python -m pip show pygame
python3 -m pip show pygame

The pip show pygame command will either state that the package is not
installed or show a bunch of information about the package, including the
location where the package is installed.

# Install pygame on macOS or Linux

To install pygame on macOS or Linux:

1. Search for “terminal” and start the application.
2. Type pip install pygame and press Enter.

pip install pygame

# 👇️ for Python 3
pip3 install pygame

# 👇️ if you get permissions error
sudo pip3 install pygame

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pygame

# 👇️ for python 3
python3 -m pip install pygame

# 👇️ alternative if you get permissions error
pip install pygame --user

# 👇️ alternative for Ubuntu/Debian/Mint
sudo apt-get install python3-pygame

# 👇️ alternative for CentOS/Fedora/Red hat
sudo yum install python3-pygame

# 👇️ alternative for OpenSUSE
sudo zypper install python3-pygame

# 👇️ alternative for Arch/Manjaro
sudo pamac install python-pygame

You can run one of the included examples with the following command.

python -m pygame.examples.aliens

python3 -m pygame.examples.aliens

py -m pygame.examples.aliens

If you get an error that pip isn’t found, use the python -m command.

python -m pip install pygame

python3 -m pip install pygame

If you get a permissions error, prefix the command with sudo.

sudo pip install pygame

sudo pip3 install pygame

Alternatively, you can install the pygame package in a virtual environment:

1. Open your terminal in the root directory of your project.
2. Run the following commands.

# 👇️ could also be "python -m venv venv"
python3 -m venv venv

# 👇️ activate virtual env on macOS or Linux
source venv/bin/activate

# 👇️ install pygame in virtual environment
pip install pygame

Your virtual environment will use the version of Python that was used to create
it.

You can use the pip show command to verify
pygame has been installed
successfully.

pip show pygame
pip3 show pygame

python -m pip show pygame
python3 -m pip show pygame

The pip show pygame command will either state that the package is not
installed or show a bunch of information about the package.

# Install pygame in Visual Studio Code

To install pygame in Visual Studio Code:

1. Press CTRL + ` (Backtick) on your keyboard to open the terminal.
2. Run the pip install pygame command to install the pygame module.

pip install pygame

# 👇️ for Python 3
pip3 install pygame

# 👇️ if you get permissions error
sudo pip3 install pygame

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pygame

# 👇️ for python 3
python3 -m pip install pygame

# 👇️ using py alias
py -m pip install pygame

# 👇️ alternative if you get permissions error
pip install pygame --user

You can run one of the included examples with the following command.

python -m pygame.examples.aliens

python3 -m pygame.examples.aliens

py -m pygame.examples.aliens

When installing Python modules in Visual Studio code, make sure that
your IDE is configured to use the correct Python version.

Press CTRL+Shift+P or (⌘ + Shift + P on Mac) to open the command
palette.

Then type “Python select interpreter” in the field.

Then select the correct Python version from the dropdown menu.

You can use the python --version command if you need to get your version of
Python.

python --version
python3 --version

You can also try creating a virtual environment if you don’t already have one.

# 👇️ could also be "python -m venv venv" or "py -m venv venv"
python3 -m venv venv

# 👇️ activate on Unix or MacOS
source venv/bin/activate

# 👇️ activate on Windows (cmd.exe)
venv\Scripts\activate.bat

# 👇️ activate on Windows (PowerShell)
venv\Scripts\Activate.ps1

# 👇️ install pygame in virtual environment
pip install pygame

Your virtual environment will use the version of Python that was used to create
it.

# Install pygame in PyCharm

To install pygame in PyCharm:

1. Press Alt+F12 on your keyboard to open the terminal.
2. Run the pip install pygame command to install the pygame module.

pip install pygame

# 👇️ for Python 3
pip3 install pygame

# 👇️ if you get permissions error
sudo pip3 install pygame

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pygame

# 👇️ for python 3
python3 -m pip install pygame

# 👇️ using py alias
py -m pip install pygame

# 👇️ alternative if you get permissions error
pip install pygame --user

You can run one of the included examples with the following command.

python -m pygame.examples.aliens

python3 -m pygame.examples.aliens

py -m pygame.examples.aliens

Alternatively, you can use the IDE itself to install the module.

1. Click on “File” > “Settings” > “Project” > “Python Interpreter”.
2. Click on the + icon and type pygame.
3. Click on “Install Package”.

Click on “File” > “Settings” > “Project” > “Python Interpreter”.

Then select the correct Python version from the dropdown menu.

You can use the python --version command if you need to get your version of
Python.

python --version
python3 --version

Click on the
following article
if you need to install a specific version of the package using Anaconda.

# Install pygame in Jupyter Notebook

To install pygame in Jupyter Notebook:

1. Open your terminal and type “jupyter notebook”.

2. Click on “New” and then “Terminal” in the browser tab.

3. Type pip install pygame and press Enter.

# 👇️ using pip
pip install pygame

# 👇️ for Python 3
pip3 install pygame

# 👇️ if you get permissions error
sudo pip3 install pygame

# 👇️ if you don't have pip in your PATH environment variable
python -m pip install pygame

# 👇️ for python 3
python3 -m pip install pygame

# 👇️ using py alias
py -m pip install pygame

# 👇️ using conda
conda install -c anaconda pygame

# 👇️ alternative if you get permissions error
pip install pygame --user

You can run one of the included examples with the following command.

python -m pygame.examples.aliens

python3 -m pygame.examples.aliens

py -m pygame.examples.aliens

Alternatively, you can use the Python ipykernel.

1. Open your terminal and type “jupyter notebook”.

2. Click on “New” and then click on “Python 3 (ipykernel)”.
   

3. Type !pip install pygame and click on “Run”.

Note that the pip install command must be prefixed with an exclamation mark if
you use this approach.

!pip install pygame

Once you type the command, click “Run” to install the pygame module.

If you get a permissions error, e.g. “[WinError: 5] Access is denied”, add the
--user option to the installation command.

!pip install pygame --user

如果错误仍然存​​在，请尝试
重新启动 Jupyter 内核
并重新运行该命令。