{
  "id": "pip/wheel-manylinux-incompatible",
  "signature": "ERROR: <package>.whl is not a supported wheel on this platform. It is not compatible with this Python interpreter or platform.",
  "signature_zh": "错误：<package>.whl 不是此平台支持的 wheel。它与当前 Python 解释器或平台不兼容。",
  "regex": "ERROR: .*\\.whl is not a supported wheel on this platform",
  "domain": "pip",
  "category": "install_error",
  "subcategory": null,
  "root_cause": "The wheel file's platform tag (e.g., manylinux2014_x86_64) does not match the user's system architecture or Python version, often due to downloading a wheel for a different OS or Python ABI.",
  "root_cause_type": "generic",
  "root_cause_zh": "wheel 文件的平台标签（例如 manylinux2014_x86_64）与用户系统架构或 Python 版本不匹配，通常是因为下载了针对不同操作系统或 Python ABI 的 wheel。",
  "versions": [
    {
      "version": "pip 21.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "pip 23.0",
      "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"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Re-download the same wheel file from PyPI manually.",
      "why_fails": "The wheel file itself is correct; the issue is platform incompatibility, not file corruption.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    },
    {
      "action": "Use --no-index and point to a local wheelhouse without checking tags.",
      "why_fails": "pip still validates platform tags even with --no-index; this flag only skips index lookup.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    },
    {
      "action": "Force install with --force-reinstall ignoring warnings.",
      "why_fails": "pip will abort with an error; --force-reinstall does not bypass platform tag checks.",
      "fail_rate": 1.0,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Install the source distribution instead: `pip install <package> --no-binary :all:`",
      "success_rate": 0.9,
      "how": "Install the source distribution instead: `pip install <package> --no-binary :all:`",
      "condition": "",
      "sources": []
    },
    {
      "action": "Download the correct wheel for your platform: check Python version (e.g., `python3 -c 'import sys; print(sys.version)'`) and platform (`uname -m`), then find compatible wheel at https://pypi.org/project/<package>/#files",
      "success_rate": 0.85,
      "how": "Download the correct wheel for your platform: check Python version (e.g., `python3 -c 'import sys; print(sys.version)'`) and platform (`uname -m`), then find compatible wheel at https://pypi.org/project/<package>/#files",
      "condition": "",
      "sources": []
    },
    {
      "action": "Use `pip install <package>==version --only-binary=:all:` with `--platform` and `--python-version` flags if cross-compiling: `pip install <package> --platform manylinux2014_x86_64 --python-version 3.10 --implementation cp --abi cp310`",
      "success_rate": 0.75,
      "how": "Use `pip install <package>==version --only-binary=:all:` with `--platform` and `--python-version` flags if cross-compiling: `pip install <package> --platform manylinux2014_x86_64 --python-version 3.10 --implementation cp --abi cp310`",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "改为安装源码发行版：`pip install <package> --no-binary :all:`",
    "下载适合你平台的 wheel：检查 Python 版本（`python3 -c 'import sys; print(sys.version)'`）和架构（`uname -m`），然后在 https://pypi.org/project/<package>/#files 找到兼容的 wheel",
    "使用 `--platform` 和 `--python-version` 标志进行交叉编译：`pip install <package> --platform manylinux2014_x86_64 --python-version 3.10 --implementation cp --abi cp310`"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://pip.pypa.io/en/stable/cli/pip_install/#wheel-support",
  "official_doc_section": null,
  "error_code": "ERROR",
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.92,
  "resolvable": "true",
  "first_seen": "2023-03-15",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}