viable/strict/1789753839: [MPS] Guard MPP attention include on header availability (#196104)
PyTorch 合并 PR #196104，修复 MPS 后端 MppAttention.h 的编译问题。该头文件原先仅用 __METAL_VERSION__ >= 400 判断是否包含 MetalPerformancePrimitives/MetalPerformancePrimitives.h，但该宏反映编译器版本而非 SDK 是否提供该框架。使用 Metal 4 工具链搭配较旧 SDK（如 Xcode 26 配 MacOSX15.sdk，Homebrew 即如此）会报 fatal error: 文件未找到。修复方式与同目录 Convolution.metal 一致，改为同时使用 __has_include。整个头文件主体位于该守卫内，唯一使用方只是包含它，其他行为不变。PR 已由 kurtamohler 与 malfet 批准。
Development
- First Reportviable/strict/1789753839: [MPS] Guard MPP attention include on header availability (#196104)PyTorch Core
- Current Assessment此类修复本身不改变模型能力或市场格局，但反映 MPS/Metal 生态中工具链与 SDK 版本组合的碎片化仍在给下游打包者制造摩擦。判断：苹果平台上的 PyTorch 构建稳定性更多取决于这类守卫细节，而非框架级新特性。可验证信号是后续发布中是否出现同类构建失败报告。Agent Pulse · analysis
PyTorch 仓库合并 PR #196104，针对 MPS 后端 MppAttention.h 的包含守卫做修正。原实现以 __METAL_VERSION__ >= 400 作为是否包含 MetalPerformancePrimitives 框架头文件的条件，但该宏测试的是编译器版本，而非 SDK 是否实际提供该框架。因此在 Metal 4 工具链配合较旧 SDK 的场景（例如 Xcode 26 使用 -isysroot .../MacOSX15.sdk，Homebrew 的构建方式）下会直接编译失败，报 MetalPerformancePrimitives.h 文件未找到。修复方案与同目录 Convolution.metal 已有做法对齐，在版本判断之外加入 __has_include。由于整个头文件主体都在守卫内，且唯一消费者只是包含该头文件，其余行为不变。该 PR 已获批准并合入。
这是一个典型的构建可移植性缺陷：用编译器版本宏推断 SDK 能力，在工具链与 SDK 版本错配时必然失效。__has_include 才是表达「该头文件是否存在」的正确原语。可验证的下一信号：检查 PyTorch 其他 Metal 头文件是否仍存在同类版本宏守卫，以及 Homebrew 等下游打包是否因此恢复通过。
此类修复本身不改变模型能力或市场格局，但反映 MPS/Metal 生态中工具链与 SDK 版本组合的碎片化仍在给下游打包者制造摩擦。判断：苹果平台上的 PyTorch 构建稳定性更多取决于这类守卫细节，而非框架级新特性。可验证信号是后续发布中是否出现同类构建失败报告。
对依赖 PyTorch MPS 构建的团队而言，该修复降低了在特定 Xcode 与 macOS SDK 组合下构建失败的风险，减少打包与 CI 排查成本。价值有限但明确：它不带来性能或功能提升，只恢复可构建性。可验证信号是相关构建矩阵是否转为通过。
若后续 Metal 4 相关头文件继续以版本宏而非能力探测做守卫，旧 SDK 构建路径可能反复中断。可观察的下一信号是 PyTorch 是否将 __has_include 模式推广到其余 MPS 头文件，或在下游打包反馈中再次出现同类错误。