viable/strict/1786861670: Document the main build stages at the top of CMakeLists.txt (#193615)
PyTorch 在根 CMakeLists.txt 顶部添加了注释，列出构建的九个阶段及其对应的 cmake/ 模块或子目录，并更新了 spin develop 和 spin install 的文档字符串。此更改仅涉及注释，不改变构建行为。
发展脉络
- 首次出现viable/strict/1786861670: Document the main build stages at the top of CMakeLists.txt (#193615)PyTorch Core
- 行业反馈trunk/8bd9c2032e242bfc018e75015e93f29607a81289: Document the main build stages at the top of CMakeLists.txt (#193615)PyTorch Core
- 当前判断PyTorch 作为主流深度学习框架，其构建系统的可维护性对依赖它的下游项目至关重要。此文档改进虽小，但体现了开源项目在成熟阶段对开发者体验的重视，可能减少新贡献者的上手时间。Agent Pulse · 分析
PyTorch 的根 CMakeLists.txt 文件之前没有构建流程的概览，导致开发者需要阅读整个文件才能找到特定构建部分的位置。本次提交在文件顶部添加了一个简短的注释，按执行顺序列出了九个构建阶段：引导和环境变量转发、预构建子模块/NCCL 设置、选项、依赖、代码生成、主构建、导出及可选二进制/JNI、Python 打包和配置摘要，每个阶段都指明了实现它的 cmake/ 模块或子目录。第一阶段指向 cmake/EnvVarForwarding.cmake，并指出了例外情况（如 MKLROOT/ROCM_PATH 等第三方路径和一些直接读取的标志）。spin develop 和 spin install 的文档字符串也增加了一句话指向这两个文件。此更改仅涉及注释，不改变构建行为。每个阶段的描述都与其命名的模块进行了交叉检查，并通过 BUILD_CONFIG spin develop、spin develop --help、spin install --help 等命令进行了验证。
此更改通过提供构建阶段的显式映射，降低了 PyTorch 构建系统的认知负担。开发者现在可以快速定位环境变量处理、代码生成或打包等特定功能的实现位置，而无需通读整个 CMakeLists.txt。这反映了大型开源项目在维护复杂构建系统时对可导航性的需求。
PyTorch 作为主流深度学习框架，其构建系统的可维护性对依赖它的下游项目至关重要。此文档改进虽小，但体现了开源项目在成熟阶段对开发者体验的重视，可能减少新贡献者的上手时间。
对于使用 PyTorch 的企业，构建系统的清晰文档可以减少内部团队在定制构建时的调试时间，间接降低工程成本。但此更改本身不直接影响产品功能或性能。
未来，PyTorch 可能会进一步模块化构建系统，或将此注释转化为自动生成的文档，以保持与实际构建逻辑的同步。开发者可以关注构建系统是否有更结构化的重构。