Could not build wheels for optree, which is required to install pyproject.toml-based projects

### 解决方案

当遇到无法为 `optree` 构建 wheel 的问题时，通常是因为缺少必要的编译工具或依赖项。为了顺利安装基于 `pyproject.toml` 配置文件的项目并解决构建轮子失败的问题，可以采取以下措施：

#### 安装必需的开发工具和库

对于 Linux 用户来说，可能需要安装一些额外的包来支持项目的构建过程[^4]。

sudo apt-get update && sudo apt-get install -y \
    python3-dev \
    build-essential \
    libopenblas-dev \
    liblapack-dev \
    gfortran

这些命令会安装 Python 开发头文件和其他用于编译扩展模块所必需的基础组件。

#### 使用 Conda 创建隔离环境

考虑到兼容性和便捷性，推荐使用 Anaconda 或 Miniconda 来管理虚拟环境以及处理复杂的依赖关系[^5]。

1. 下载并安装 Miniconda（如果尚未安装）。
2. 利用 conda 命令创建一个新的 Python 环境，并激活该环境。

   conda create --name myenv python=3.x
   conda activate myenv

3. 在新环境中通过 pip 或者 conda 渠道尝试重新安装目标包。

#### 更新 PyProject TOML 文件中的构建设置

确保 `pyproject.toml` 文件内指定了合适的构建系统需求版本号，这有助于避免因不匹配而引起的错误[^1]。

[build-system]
requires = [
    "setuptools>=60",
    "wheel"
]
build-backend = "setuptools.build_meta"

[project]
...
dependencies = [
    ...
]

注意这里将 setuptools 版本提升到了至少 60 及以上，因为较新的版本可能会修复某些已知的问题。

#### 处理特定平台上的编译器缺失情况

如果是 Windows 平台，则可能是由于缺乏 Microsoft Visual C++ 编译器造成的。此时应该前往微软官方网站下载并安装最新版的 **C++ Build Tools** [^2]。

---