{
  "id": "python/setup-py-deprecated",
  "signature": "SetuptoolsDeprecationWarning: setup.py install is deprecated. Use build and pip and other standards-based tools.",
  "signature_zh": "SetuptoolsDeprecationWarning：setup.py install 已弃用，请使用 build、pip 等基于标准的工具。",
  "regex": "SetuptoolsDeprecationWarning:\\ setup\\.py\\ install\\ is\\ deprecated\\.\\ Use\\ build\\ and\\ pip\\ and\\ other\\ standards\\-based\\ tools\\.",
  "domain": "python",
  "category": "install_error",
  "subcategory": null,
  "root_cause": "Running `python setup.py install` directly triggers setuptools' deprecation path. Modern setuptools expects builds via PEP 517 (pip/build) rather than the legacy setup.py commands.",
  "root_cause_type": "generic",
  "root_cause_zh": "直接运行 `python setup.py install` 会触发 setuptools 的弃用路径。现代 setuptools 期望通过 PEP 517（pip/build）构建，而不是旧的 setup.py 命令。",
  "versions": [
    {
      "version": "3.x",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Downgrading setuptools hides the warning but breaks other packages that require newer setuptools APIs.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Suppresses the message but the install still uses the deprecated path and may fail on future setuptools.",
      "fail_rate": 0.6,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "",
      "success_rate": 0.95,
      "how": "Use pip to install the project in editable mode:\npip install -e .",
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "success_rate": 0.92,
      "how": "Build a wheel with the build frontend:\npython -m pip install build\npython -m build",
      "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.87,
  "fix_success_rate": 0.8,
  "resolvable": "true",
  "first_seen": "2024-01-20",
  "last_confirmed": "2025-01-01",
  "last_updated": "2025-01-01",
  "evidence_count": 0,
  "tags": [],
  "locale": "en",
  "aliases": []
}