Pycharm报错： Preparing metadata (pyproject.toml) did not run successfully.

### 解决 PyCharm 安装包时报错 'Preparing metadata (pyproject.toml) did not run successfully'

当遇到 `Preparing metadata (pyproject.toml) did not run successfully` 错误时，这通常意味着构建过程中遇到了问题。对于特定于 Pillow 的错误消息，表明无法成功构建轮子文件（wheel），可能是因为缺少必要的编译工具或依赖项。

#### 方法一：更新 pip 和 setuptools

确保使用的 pip 和 setuptools 是最新版本可以解决许多兼容性和构建问题：

pip install --upgrade pip setuptools wheel

#### 方法二：安装预编译的二进制文件

如果直接通过源码安装失败，则尝试寻找并下载适用于当前平台的预编译 whl 文件来代替。例如针对 Pillow 可以这样做：

pip install --only-binary :all: pillow

这种方法绕过了本地编译的需求，从而避免了由于缺乏适当开发环境而导致的问题[^1]。

#### 方法三：确认 Visual C++ Build Tools 已安装

某些 Python 扩展模块在 Windows 上需要 Microsoft Visual C++ Compiler 来完成其构建过程。可以通过安装 Visual Studio 或者单独获取 Visual C++ Build Tools 来提供这些组件支持。

访问 [Visual Studio 下载页面](https://visualstudio.microsoft.com/zh-cn/downloads/) 并按照指示操作即可获得所需资源。

#### 方法四：调整项目解释器设置

有时 PyCharm 中配置的虚拟环境中可能存在冲突或其他异常情况。可以在 IDE 设置里切换到不同的 Python 解释器试试看是否会改善状况；另外也可以考虑创建一个新的干净虚拟环境来进行测试。

---