Python 3.12安装wordcloud包报错求助：AttributeError问题

在Python 3.12环境下执行pip install wordcloud时出现如下错误：

C:\Users\y>pip install wordcloud
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\y\pythonProject\venv\Scripts\pip.exe\__main__.py", line 4, in <module>
  File "C:\Users\y\pythonProject\venv\Lib\site-packages\pip\_internal\cli\main.py", line 9, in <module>
    from pip._internal.cli.autocompletion import autocomplete
  File "C:\Users\y\pythonProject\venv\Lib\site-packages\pip\_internal\cli\autocompletion.py", line 10, in <module>
    from pip._internal.cli.main_parser import create_main_parser
  File "C:\Users\y\pythonProject\venv\Lib\site-packages\pip\_internal\cli\main_parser.py", line 8, in <module>
    from pip._internal.cli import cmdoptions
  File "C:\Users\y\pythonProject\venv\Lib\site-packages\pip\_internal\cli\cmdoptions.py", line 23, in <module>
    from pip._internal.cli.parser import ConfigOptionParser
  File "C:\Users\y\pythonProject\venv\Lib\site-packages\pip\_internal\cli\parser.py", line 12, in <module>
    from pip._internal.configuration import Configuration, ConfigurationError
  File "C:\Users\y\pythonProject\venv\Lib\site-packages\pip\_internal\configuration.py", line 20, in <module>
    from pip._internal.exceptions import (
  File "C:\Users\y\pythonProject\venv\Lib\site-packages\pip\_internal\exceptions.py", line 7, in <module>
    from pip._vendor.pkg_resources import Distribution
  File "C:\Users\y\pythonProject\venv\Lib\site-packages\pip\_vendor\pkg_resources\__init__.py", line 2164, in <module>
    register_finder(pkgutil.ImpImporter, find_on_path)
                    ^^^^^^^^^^^^^^^^^^^
AttributeError: module 'pkgutil' has no attribute 'ImpImporter'. Did you mean: 'zipimporter'?

问题原因 #

Python 3.12正式移除了pkgutil.ImpImporter这个已废弃的API，而当前虚拟环境中的pip版本过旧，仍在依赖该API，导致执行pip命令时触发错误。

解决方法 #

• 方法一：升级pip
  因为直接调用pip命令已经报错，改用Python自带的ensurepip模块来升级pip：

  python -m ensurepip --upgrade
  

  升级完成后，再次执行安装命令：

  pip install wordcloud
  

• 方法二：重新创建虚拟环境
  如果升级pip后问题仍存在，建议重建虚拟环境，确保环境依赖与Python 3.12兼容：

  1. 删除现有虚拟环境（Windows命令）：

     rmdir /s C:\Users\y\pythonProject\venv
     

  2. 重新创建虚拟环境：

     python -m venv C:\Users\y\pythonProject\venv
     

  3. 激活虚拟环境：

     C:\Users\y\pythonProject\venv\Scripts\activate
     

  4. 执行安装命令：

     pip install wordcloud
     

• 方法三：直接通过Python模块调用pip安装
  绕开可能损坏的pip.exe，直接用Python模块方式执行安装：

  python -m pip install wordcloud
  

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