解决psutil在macOS 15上的编译问题：kIOMainPortDefault兼容性处理

在macOS 15系统上编译psutil项目时，开发者可能会遇到一个典型的兼容性问题，表现为编译失败并提示"kIOMainPortDefault is only available on macOS 12.0 or newer"。这个问题源于macOS系统API的版本演进，需要开发者进行适当的兼容性处理。

问题本质分析

该问题的核心在于macOS 12.0引入的kIOMainPortDefault常量替代了旧版的kIOMasterPortDefault。当编译环境的最低部署目标(macOS deployment target)设置为11.0时，编译器会拒绝使用这个仅在12.0及以上版本可用的API。

psutil项目在cpu.c文件中使用了IOServiceGetMatchingServices函数，该函数在macOS 12.0后推荐使用kIOMainPortDefault作为参数。然而，当Python解释器本身是使用MacOS 11作为部署目标构建时，就会导致这种版本不匹配问题。

解决方案

经过深入分析，我们发现kIOMainPortDefault和kIOMasterPortDefault实际上都是指向同一个值的别名，即0。因此，最直接可靠的解决方案是直接使用0值作为参数，而不是依赖这些宏定义。

具体修改方案如下：

1. 移除原有的版本条件判断代码
2. 定义一个静态常量darwin_default_master_port并赋值为0
3. 在调用IOServiceGetMatchingServices时使用这个常量替代原有的kIOMainPortDefault

这种解决方案具有以下优势：

• 完全避免了版本兼容性问题
• 代码更加简洁明确
• 不依赖特定版本的宏定义
• 在所有macOS版本上都能正常工作

实施建议

对于使用psutil的开发者，如果遇到类似的编译问题，可以考虑以下步骤：

1. 检查本地Python环境的构建目标版本
2. 确认Xcode命令行工具已正确安装
3. 如果使用第三方Python发行版(如python-build-standalone)，了解其构建配置
4. 考虑应用上述补丁方案

这个问题的解决展示了在跨版本系统开发时处理API变更的最佳实践，即寻找最基础、最稳定的接口实现方式，而不是依赖可能变化的宏定义。