# DEPRECATION：旧式 setup.py install 已弃用。pip 24.1 将强制此行为变更。可能的替代方案是升级到更新版本的 <pkg>，或联系作者建议其发布 PEP 517 构建后端。

- **ID:** `python/pip-egg-info-deprecated-setup-py`
- **领域:** python
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

该包仅提供旧式 `setup.py` 而缺少 `pyproject.toml`，因此 pip 必须调用 `setup.py install` 而非 PEP 517 后端。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.8 | active | — | — |
| 3.9 | active | — | — |
| 3.10 | active | — | — |
| 3.11 | active | — | — |
| 3.12 | active | — | — |

## 解决方案

1. **** (85% 成功率)
   ```
   Pin a version that has migrated to pyproject.toml, or vendor the source and add a minimal pyproject.toml with `[build-system] requires=['setuptools>=61'] build-backend='setuptools.build_meta'`.
   ```
2. **** (70% 成功率)
   ```
   Silence locally with `PYTHONWARNINGS=ignore::DeprecationWarning` for CI noise only (does NOT fix the underlying issue).
   ```

## 无效尝试

- **** — The deprecation is about the missing PEP 517 metadata, not build isolation. (85% 失败率)
- **** — If the upstream project has not yet migrated, the newest release still triggers the same deprecation. (60% 失败率)