{
  "id": "pip/pep-517-backend-requires-missing-dependency",
  "signature": "ERROR: Could not install packages due to a BuildBackendException: Backend 'setuptools.build_meta' is not available. The project requires the following build dependencies: wheel, setuptools>=61.0. Check that these are installed and available in the build environment.",
  "signature_zh": "错误：由于 BuildBackendException 无法安装软件包：后端 'setuptools.build_meta' 不可用。该项目需要以下构建依赖项：wheel, setuptools>=61.0。请检查这些依赖项是否已安装并在构建环境中可用。",
  "regex": "Backend '.*' is not available.*requires the following build dependencies",
  "domain": "pip",
  "category": "build_error",
  "subcategory": null,
  "root_cause": "The build system specified in pyproject.toml (requires) lists dependencies that are not installed in the pip build environment, often because --no-build-isolation is used or the build environment lacks those packages.",
  "root_cause_type": "generic",
  "root_cause_zh": "pyproject.toml 中指定的构建系统（requires）列出的依赖项未安装在 pip 构建环境中，通常是因为使用了 --no-build-isolation 或构建环境缺少这些软件包。",
  "versions": [
    {
      "version": "pip 23.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "pip 23.3",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "pip 24.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "setuptools 68.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Installing the missing build dependencies globally with pip install setuptools wheel",
      "why_fails": "If pip is using build isolation (default), it creates a temporary build environment that does not inherit global packages; the global install has no effect.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "Adding --no-build-isolation without ensuring the build environment has the correct versions",
      "why_fails": "The global environment may have older versions of setuptools that do not satisfy the >=61.0 requirement.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    },
    {
      "action": "Deleting pyproject.toml to force legacy setup.py install",
      "why_fails": "Modern packages may not have a setup.py, and pip will refuse to install without a build backend.",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Ensure build isolation is enabled (default) and pip will automatically install the required build dependencies in the isolated environment. If you must use --no-build-isolation, pre-install the exact versions required: pip install 'setuptools>=61.0' wheel",
      "success_rate": 0.85,
      "how": "Ensure build isolation is enabled (default) and pip will automatically install the required build dependencies in the isolated environment. If you must use --no-build-isolation, pre-install the exact versions required: pip install 'setuptools>=61.0' wheel",
      "condition": "",
      "sources": []
    },
    {
      "action": "Upgrade pip to the latest version to ensure it correctly handles PEP 517/518 build requirements: pip install --upgrade pip",
      "success_rate": 0.75,
      "how": "Upgrade pip to the latest version to ensure it correctly handles PEP 517/518 build requirements: pip install --upgrade pip",
      "condition": "",
      "sources": []
    },
    {
      "action": "Manually create a build environment with the required dependencies and then install the package using pip install --no-build-isolation ./package-dir after activating that environment.",
      "success_rate": 0.8,
      "how": "Manually create a build environment with the required dependencies and then install the package using pip install --no-build-isolation ./package-dir after activating that environment.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "确保构建隔离已启用（默认），pip 将自动在隔离环境中安装所需的构建依赖项。如果必须使用 --no-build-isolation，请预先安装确切的所需版本：pip install 'setuptools>=61.0' wheel",
    "将 pip 升级到最新版本，以确保其正确处理 PEP 517/518 构建要求：pip install --upgrade pip",
    "手动创建具有所需依赖项的构建环境，然后在激活该环境后使用 pip install --no-build-isolation ./package-dir 安装软件包。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://pip.pypa.io/en/stable/reference/build-system/",
  "official_doc_section": null,
  "error_code": "ERROR",
  "verification_tier": "ai_generated",
  "confidence": 0.87,
  "fix_success_rate": 0.8,
  "resolvable": "true",
  "first_seen": "2023-09-05",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}