PyCharm无法添加第三方库，报错ModuleNotFoundError: No module named 'distutils'

问题分析 #

报错核心是当前Python解释器缺少distutils模块，该模块是pip依赖的核心组件，部分Python安装（尤其是自定义编译或精简版）可能未默认包含。

解决方案 #

1. 验证解释器是否缺失distutils

打开终端，使用PyCharm当前配置的Python解释器执行：

python -c "import distutils; print(distutils.__file__)"

若执行报错，说明该解释器确实未安装distutils。

2. 安装distutils

根据你的操作系统选择对应方式：

• Windows：
  重新运行Python官方安装包，勾选「Add Python to PATH」，点击「Modify」，确保「Optional Features」中的「distutils」已勾选，完成修改安装。
• Ubuntu/Debian类Linux：
  执行对应Python版本的安装命令（以Python3.10为例）：

  sudo apt-get install python3.10-distutils
  

• macOS：
  若使用Homebrew安装的Python，重新安装Python：

  brew reinstall python
  

  若使用系统Python，先安装Xcode命令行工具：

  xcode-select --install
  

3. 配置PyCharm使用正确的解释器

1. 打开PyCharm，依次进入File > Settings > Project: [你的项目名] > Python Interpreter
2. 点击右上角齿轮图标，选择「Add」
3. 定位到已安装distutils的Python解释器路径，添加并设置为项目默认解释器。

4. 手动安装第三方库（备选方案）

若PyCharm内置安装仍有问题，直接在终端使用正确的解释器执行安装命令：

pip install [需要安装的库名]

完成后回到PyCharm，点击Python Interpreter界面的刷新按钮即可。

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