一、工程选型建议
核心结论
- 应用项目（Web / API / Lambda）：
pyproject.toml + requirements.lock.txt
- 库 / SDK / 内部包：必须
pyproject.toml
- 老项目 / 轻量脚本 / 运维：
requirements.txt
| 场景 | 推荐 |
|---|
| 新项目 | ⭐ pyproject.toml |
| 企业级 / 长期维护 | ⭐ pyproject.toml |
| Lambda / Docker | pyproject + lock |
| 一次性脚本 | requirements.txt |
| 发布私有包 | pyproject.toml |
二、requirements.txt 规范（传统但仍重要）
1️⃣ 基础规范（强制）
# 基础依赖（生产环境）
requests==2.32.3
boto3==1.34.162
pydantic>=2.6,<3.0
规则
| 规则 | 说明 |
|---|
| 一行一个依赖 | 禁止多包 |
| 必须锁主依赖 | == 或 >=,< |
| 禁止裸版本 | ❌ requests |
| 禁止安装时逻辑 | ❌ shell 命令 |
2️⃣ 分环境拆分（推荐）
# requirements/base.txt
requests==2.32.3
boto3==1.34.162
# requirements/dev.txt
-r base.txt
pytest==8.3.2
black==24.4.2
# requirements/prod.txt
-r base.txt
gunicorn==22.0.0
3️⃣ requirements.lock.txt（企业级）
requests==2.32.3
urllib3==2.2.2
certifi==2024.7.4
charset-normalizer==3.3.2
