如何安装pygame
windows11 + Python3.14.3环境,使用pip 安装模块总是失败,以pip install PySide6为例,提示如下:
Collecting PySide6_Addons==6.10.2 (from PySide6)
Downloading https://pypi.tuna.tsinghua.edu.cn/packages/99/13/503bec9201881968c372cb634069535e80aec2489f3907d676e151a1023f/pyside6_addons-6.10.2-cp39-abi3-win_amd64.whl (164.7 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 164.7/164.7 MB 69.4 MB/s0:00:02
Installing collected packages: shiboken6, PySide6_Essentials, PySide6_Addons, PySide6
Successfully installed PySide6-6.10.2 PySide6_Addons-6.10.2 PySide6_Essentials-6.10.2 shiboken6-6.10.2
A new release of pip is available: 25.3 -> 26.0.1
To update, run: python.exe -m pip install --upgrade pip
ERROR: Exception:
Traceback (most recent call last):
File "C:\Users\SUN366\AppData\Local\Programs\Python\Python314\Lib\site-packages\pip\_internal\cli\base_command.py", line 107, in _run_wrapper
status = _inner_run()
File "C:\Users\SUN366\AppData\Local\Programs\Python\Python314\Lib\site-packages\pip\_internal\cli\base_command.py", line 98, in _inner_run
return self.run(options, args)
~~~~~~~~^^^^^^^^^^^^^^^
File "C:\Users\SUN366\AppData\Local\Programs\Python\Python314\Lib\site-packages\pip\_internal\cli\req_command.py", line 85, in wrapper
return func(self, options, args)
File "C:\Users\SUN366\AppData\Local\Programs\Python\Python314\Lib\site-packages\pip\_internal\commands\install.py", line 520, in run
self._handle_target_dir(
~~~~~~~~~~~~~~~~~~~~~~~^
options.target_dir, target_temp_dir, options.upgrade
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
)
^
File "C:\Users\SUN366\AppData\Local\Programs\Python\Python314\Lib\site-packages\pip\_internal\commands\install.py", line 530, in _handle_target_dir
ensure_dir(target_dir)
~~~~~~~~~~^^^^^^^^^^^^
File "C:\Users\SUN366\AppData\Local\Programs\Python\Python314\Lib\site-packages\pip\_internal\utils\misc.py", line 99, in ensure_dir
os.makedirs(path)
~~~~~~~~~~~^^^^^^
File "<frozen os>", line 226, in makedirs
File "<frozen os>", line 226, in makedirs
File "<frozen os>", line 236, in makedirs
PermissionError: 拒绝访问。: 'C:\\Program Files\\Python314'
其中: 'C:\\Program Files\\Python314' 是上一个版本(3.14.2)的安装路径,已卸载。当前版本非此路径。
按提示升级pip,也是如此。 你好!你的问题是pip在尝试写入一个旧版本的Python安装目录,导致权限错误。虽然你安装的是PySide6,但安装pygame时会遇到同样的问题。
解决方案:
1. 以管理员身份运行命令行
由于Windows对C:\Program Files目录有权限限制,请以管理员身份运行命令行:
[*]在开始菜单搜索“cmd”或“命令提示符”
[*]右键点击,选择“以管理员身份运行”
[*]在新打开的命令行窗口中执行pip命令
2. 使用用户模式安装(推荐)
使用 --user 参数将包安装到用户目录,避免权限问题:
pip install pygame --user
3. 升级pip到最新版本
先升级pip自身:
python -m pip install --upgrade pip --user
4. 清理pip缓存
旧路径可能保存在缓存中:
pip cache purge
5. 使用虚拟环境(最推荐)
创建一个虚拟环境来隔离项目依赖:
# 创建虚拟环境
python -m venv myenv
# 激活虚拟环境
# Windows:
myenv\Scripts\activate
# 激活后安装pygame(不需要管理员权限)
pip install pygame
总结建议:
最简单的方法是使用第2步的 --user 参数:
pip install pygame --user
如果还不行,建议使用第5步的虚拟环境方法,这能避免系统级的权限问题,也更利于项目管理。
注意:你的错误信息显示的是旧路径 C:\Program Files\Python314,这说明虽然你卸载了旧版本,但pip的某些配置或缓存还指向这个路径。使用虚拟环境或用户模式可以绕过这个问题。
以上回复来自 FishC AI 小助理,如未能正确解答您的问题,请继续追问。 FishC 发表于 2026-2-7 11:56
你好!你的问题是pip在尝试写入一个旧版本的Python安装目录,导致权限错误。虽然你安装的是PySide6,但安装 ...
请问有什么办法能清除旧路径吗? hynet1024 发表于 2026-02-07 12:03
FishC 发表于 2026-2-7 11:56
你好!你的问题是pip在 ...
清除旧Python路径残留,可以按以下步骤操作:
1. 清理pip缓存
在命令行中执行:
pip cache purge
2. 检查并修改pip配置文件
pip配置文件可能包含了旧路径,位置在:
用户配置文件: %APPDATA%\pip\pip.ini
系统配置文件: C:\ProgramData\pip\pip.ini
用记事本打开这些文件,检查是否有以下内容指向旧路径:
target = C:\Program Files\Python314
prefix = C:\Program Files\Python314
如果有,删除这些行或修改为正确路径。
3. 检查环境变量
右键"此电脑"→"属性"→"高级系统设置"→"环境变量",检查:
[*]用户变量和系统变量中的PATH:删除任何指向 C:\Program Files\Python314 的项
[*]检查是否有 PYTHONPATH 变量,如果指向旧路径,删除或修正它
4. 检查Python安装目录下的配置文件
查看当前Python安装目录(如 C:\Users\SUN366\AppData\Local\Programs\Python\Python314)中是否有:
pyvenv.cfg 或 pip.ini
检查其中是否包含旧路径。
5. 重置pip配置
如果找不到问题,可以重置pip配置:
pip config unset global.target
pip config unset global.prefix
pip config unset install.target
pip config unset install.prefix
6. 重新安装pip
如果问题依旧,重新安装pip:
python -m ensurepip --upgrade
7. 检查注册表(谨慎操作)
如果以上都不行,可能是注册表残留。按Win+R,输入 regedit,搜索 Python314,找到旧路径相关项并删除。注意:修改注册表有风险,建议先备份。
推荐解决方案:
最简单的办法是使用虚拟环境,完全避免系统路径问题:
# 创建虚拟环境
python -m venv myenv
# 激活
myenv\Scripts\activate
# 在虚拟环境中安装pygame
pip install pygame
这样既解决了路径问题,又保持了环境干净。
以上回复来自 FishC AI 小助理,如未能正确解答您的问题,请继续追问。
页:
[1]