{
  "id": "python/pip-build-isolation-missing-build-dependencies",
  "signature": "ERROR: Could not build wheels for some-package, which is required to install pyproject.toml-based projects",
  "signature_zh": "错误：无法为 some-package 构建 wheel，这是安装基于 pyproject.toml 的项目所必需的",
  "regex": "ERROR:\\ Could\\ not\\ build\\ wheels\\ for\\ some\\-package,\\ which\\ is\\ required\\ to\\ install\\ pyproject\\.toml\\-based\\ projects",
  "domain": "python",
  "category": "install_error",
  "subcategory": null,
  "root_cause": "pip attempted to build a wheel in an isolated environment but failed because the build dependencies specified in pyproject.toml are not available or cannot be installed, often due to network issues or missing system libraries.",
  "root_cause_type": "generic",
  "root_cause_zh": "pip 尝试在隔离环境中构建 wheel，但失败，因为 pyproject.toml 中指定的构建依赖不可用或无法安装，通常是由于网络问题或缺少系统库。",
  "versions": [
    {
      "version": "3.8",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.9",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.10",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.11",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.12",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Requires build dependencies to be already installed in the current environment; often they are not, leading to different errors.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Does not resolve missing system libraries or network issues.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "",
      "success_rate": 0.85,
      "how": "Install build dependencies manually: pip install build, then run python -m build to see detailed errors, and install missing system packages (e.g., libffi-dev, python3-dev).",
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "success_rate": 0.75,
      "how": "Use a pre-built wheel if available: pip install --only-binary :all: some-package.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": null,
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.86,
  "fix_success_rate": 0.8,
  "resolvable": "true",
  "first_seen": "2024-11-15",
  "last_confirmed": "2025-01-01",
  "last_updated": "2025-01-01",
  "evidence_count": 0,
  "tags": [],
  "locale": "en",
  "aliases": []
}