pip报错ModuleNotFoundError: 找不到pip._vendor.pygments.styles._mapping模块求助

问题背景 #

之前尝试安装pystray模块，提示下载成功但VSCode无法识别，在VSCode的虚拟环境（venv）中重新安装后仍无效，随后所有pip命令均抛出以下错误：

Traceback (most recent call last):
File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\__main__.py", line 22, in <module>
    from pip._internal.cli.main import main as _main
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_internal\cli\main.py", line 10, in <module>
    from pip._internal.cli.autocompletion import autocomplete
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_internal\cli\autocompletion.py", line 9, in <module>
    from pip._internal.cli.main_parser import create_main_parser
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_internal\cli\main_parser.py", line 8, in <module>
    from pip._internal.build_env import get_runnable_pip
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_internal\build_env.py", line 16, in <module>
    from pip._internal.cli.spinners import open_spinner
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_internal\cli\spinners.py", line 9, in <module>
    from pip._internal.utils.logging import get_indentation
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_internal\utils\logging.py", line 22, in <module>
    from pip._vendor.rich.logging import RichHandler
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_vendor\rich\logging.py", line 15, in <module>
    from .traceback import Traceback
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_vendor\rich\traceback.py", line 44, in <module>
    from .syntax import Syntax, SyntaxPosition
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_vendor\rich\syntax.py", line 24, in <module>
    from pip._vendor.pygments.styles import get_style_by_name
  File "C:\Users\Uporabnik\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\pip\_vendor\pygments\styles\__init__.py", line 13, in <module>
    from pip._vendor.pygments.styles._mapping import STYLES
ModuleNotFoundError: No module named 'pip._vendor.pygments.styles._mapping'

解决步骤 #

1. 用ensurepip修复pip #

打开命令提示符（CMD）或PowerShell，执行以下命令，让Python自带工具修复并升级pip：

python -m ensurepip --upgrade

该命令会自动修复pip的损坏文件，替换缺失组件。

2. 强制重新安装pip #

如果上述方法无效，直接重新安装pip：

• 先下载安装脚本：

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

• 执行脚本强制覆盖安装：

python get-pip.py --force-reinstall

3. 重置虚拟环境 #

若问题出在VSCode的虚拟环境中，按以下步骤重置：

• 退出当前虚拟环境：
  Windows：deactivate
  Linux/macOS：source venv/bin/deactivate
• 删除项目中的venv文件夹
• 重新创建虚拟环境：

python -m venv venv

• 激活新虚拟环境：
  Windows：venv\Scripts\activate
  Linux/macOS：source venv/bin/activate
• 重新安装pystray：

pip install pystray

4. 验证修复 #

执行pip --version，若能正常显示pip版本信息，说明修复成功，可尝试安装其他包测试功能是否正常。

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