# SetuptoolsDeprecationWarning：setup.py install 已弃用，请使用 build、pip 等基于标准的工具。

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

## 根因

直接运行 `python setup.py install` 会触发 setuptools 的弃用路径。现代 setuptools 期望通过 PEP 517（pip/build）构建，而不是旧的 setup.py 命令。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.x | active | — | — |

## 解决方案

1. **** (95% 成功率)
   ```
   Use pip to install the project in editable mode:
pip install -e .
   ```
2. **** (92% 成功率)
   ```
   Build a wheel with the build frontend:
python -m pip install build
python -m build
   ```

## 无效尝试

- **** — Downgrading setuptools hides the warning but breaks other packages that require newer setuptools APIs. (70% 失败率)
- **** — Suppresses the message but the install still uses the deprecated path and may fail on future setuptools. (60% 失败率)