Pipenv 新增 requirements 子命令支持基于 Pipfile 生成依赖列表

在 Python 项目开发中，开发者经常需要在应用程序开发（需要固定所有依赖版本）和库开发（不需要固定依赖版本以避免冲突）两种场景间切换。Pipenv 作为流行的 Python 依赖管理工具，最近新增了一个实用功能，能够直接从 Pipfile 生成 requirements.txt 格式的依赖列表，而不需要依赖 Pipfile.lock 文件。

功能背景

传统上，Pipenv 主要通过 Pipfile 和 Pipfile.lock 文件管理项目依赖。Pipfile 声明顶层依赖关系，而 Pipfile.lock 则记录精确的依赖版本和完整的依赖树。然而在某些场景下，开发者只需要获取 Pipfile 中声明的顶层依赖，而不需要完整的锁定依赖树。

这种需求在库开发中尤为常见。库开发者通常不希望过度约束依赖版本，以避免与其他库产生冲突。同时，他们又需要一种简单的方式将依赖声明导出为 requirements.txt 格式，用于构建工具、CI/CD 流程或其他不支持 Pipenv 的环境。

新功能详解

新实现的 pipenv requirements 子命令增加了直接从 Pipfile 提取依赖的能力。该功能支持：

1. 仅输出 Pipfile 中声明的顶层依赖项
2. 支持按类别（如常规依赖、开发依赖等）筛选依赖
3. 保持原始 Pipfile 中指定的版本约束

使用示例：

# 输出所有顶层依赖
pipenv requirements --NEW_OPTION

# 仅输出特定类别的依赖（如style类别）
pipenv requirements --NEW_OPTION --categories style

技术实现原理

该功能的核心是解析 Pipfile 文件结构，提取其中的依赖声明部分。与传统的基于 Pipfile.lock 的导出不同，新实现：

1. 直接读取 Pipfile 的 TOML 格式内容
2. 解析 packages 和其他指定类别下的依赖项
3. 将依赖名称和约束条件转换为 requirements.txt 格式
4. 完全跳过依赖解析和锁定步骤，保持轻量级

应用场景

这一功能特别适用于以下场景：

1. 库开发项目：在 setup.py 或 pyproject.toml 中动态指定依赖
2. 多环境兼容：为不支持 Pipenv 的环境提供兼容的依赖声明
3. CI/CD 集成：简化构建流程中的依赖管理
4. 依赖文档化：生成项目依赖的简明文档

最佳实践建议

1. 对于应用程序开发，仍建议使用 Pipfile.lock 确保环境一致性
2. 库项目可以使用此功能生成安装时依赖声明
3. 可以将此命令集成到项目的构建前脚本中，自动保持依赖同步
4. 考虑在 CI 流程中验证 Pipfile 和生成的 requirements.txt 一致性

这一功能的加入使 Pipenv 在保持原有优势的同时，更好地适应了不同 Python 项目的依赖管理需求，特别是为库开发者提供了更大的灵活性。开发者现在可以更轻松地在严格版本控制和宽松依赖声明之间切换，而无需维护多个依赖声明文件。