执行摘要
此 PR 对 vllm 项目的 requirements/ 目录进行了重构，将构建和测试专用的依赖文件移动到 requirements/build/ 和 requirements/test/ 子目录中。通过更新 pre-commit 钩子、Dockerfiles 及多个工具脚本的路径引用，提升了依赖管理的整洁度和跨设备（CUDA、ROCm、XPU）的一致性。这是一个低风险的维护性变更，对用户无直接影响，但有助于团队长期维护。
功能与动机
当前 requirements/ 目录中混合了用户、构建和测试需求文件，导致“噪音”和依赖管理不一致。根据 PR body，此变更旨在“减少噪音并提高跨设备依赖管理的一致性”。具体来说，通过标准化文件布局，使构建和测试依赖更易于查找和维护，尤其利于多设备环境下的统一处理。
实现拆解
变更主要分为以下步骤：
- 移动测试需求文件：将所有测试专用文件（如
rocm-test.in、xpu-test.in）重命名并移动到 requirements/test/ 子目录。例如，requirements/rocm-test.in 变为 requirements/test/rocm.in，并更新文件内容中的相对路径（如将 -r common.txt 改为 -r ../common.txt）。
- 移动构建需求文件：类似地，构建专用文件被移至
requirements/build/ 子目录（上下文未详述，但提交历史提及“Standardise build requirements too”）。
- 更新配置和工具脚本：同步修改多个文件以适配新路径：
.pre-commit-config.yaml：调整 pip-compile 钩子的参数和 files 模式。关键变更包括为 CUDA、ROCm 和新增的 XPU 设备统一指定输入输出路径，并更新文件匹配模式。例如：
- id: pip-compile
args: [
requirements/test/cuda.in, # 输入文件改为新路径
-c, requirements/cuda.txt,
-o, requirements/test/cuda.txt, # 输出文件移至子目录
--index-strategy, unsafe-best-match,
--torch-backend, cu130,
--python-platform, x86_64-manylinux_2_28,
--python-version, "3.12",
]
files: ^requirements/(common|cuda|test/cuda)\.(in|txt)$ # 更新匹配模式
docs/mkdocs/hooks/generate_argparse.py：修改读取版本信息的文件路径，从 requirements/test.txt 更新为 requirements/test/cuda.txt，确保文档生成能正确获取依赖版本。tools/generate_cmake_presets.py：更新注释中的引用，从 requirements/build.txt 改为 requirements/build/cuda.txt，保持与 CMake 配置的同步。
- 测试和部署配套：更新了测试脚本（如
tests/standalone_tests/pytorch_nightly_dependency.sh）和 Dockerfiles（如 docker/Dockerfile），调整命令中的文件路径，确保 CI/CD 流程不受影响。
评论区精华
Review 讨论较少，核心要点如下：
- gemini-code-assist[bot] 总结：“此 PR 重组了需求文件……我无反馈可提供。”
- jikunshang 指出：“Intel CI 因已知问题失败，但可忽略并推进。”
- hmellor 强调：“由于此 PR 仅移动文件，所有失败应无关。”
团队一致认为变更低风险，批准合并，无重大争议。
风险与影响
风险：主要风险是路径变更可能导致配置遗漏，例如若 pre-commit 钩子的 files 模式未正确更新，可能使依赖解析失败。但 PR 已全面更新相关文件，风险可控。兼容性方面，开发者需适应新目录结构，但无核心逻辑破坏。
影响：对用户无直接影响；对系统，提升了依赖管理清晰度，长期可维护性增强；对团队，简化了文件组织，尤其利于多设备环境的一致性，但短期内需更新本地开发环境引用。
关联脉络
从历史 PR 看，此变更与依赖管理趋势一致：
- PR 40395（升级 tpu-inference）同样关注依赖版本更新，体现项目对依赖一致性的重视。
- PR 40132（更新 FP8 支持检测）涉及设备特定配置，与当前 PR 中统一处理多设备依赖的方式相呼应。
整体上，此 PR 是项目基础设施优化的一部分，旨在通过结构化目录降低维护成本。
参与讨论