MacOS下vkCreateInstance返回VK_ERROR_INCOMPATIBLE_DRIVER故障

该错误是macOS平台Vulkan实现的特殊适配要求导致的，和硬件、驱动安装状态无关——能正常运行vkcube、执行vulkaninfo已经完全排除了环境层面的故障。

• macOS不存在原生Vulkan驱动，所有Vulkan能力均通过MoltenVK封装Metal API实现，属于Vulkan Portability可移植子集实现，并非完全符合核心规范的全量Vulkan驱动。
• 从Vulkan 1.3版本Loader开始，对接Portability子集类驱动时，强制要求应用创建实例时显式声明启用Portability枚举相关的扩展与创建标志，否则会直接返回VK_ERROR_INCOMPATIBLE_DRIVER拒绝实例创建。该校验和代码中指定的apiVersion = VK_API_VERSION_1_0无关，只要链接的Loader版本≥1.3就会触发。
• 使用的GLFW 3.3.7版本不会自动为macOS平台追加Portability相关的适配配置，官方自带的vkcube、vulkaninfo工具因为预先做了这部分适配，所以可以正常运行。

按以下步骤修改实例创建逻辑即可：

1. 组装实例启用扩展列表时，在GLFW返回的必选扩展基础上，追加Portability枚举扩展，建议先做扩展存在性校验避免跨平台兼容问题：

// 初始化扩展列表，先放入GLFW要求的必选扩展
std::vector<const char*> enabled_extensions(glfw_extensions, glfw_extensions + glfw_extension_count);

// 校验Portability枚举扩展是否存在，存在则追加到启用列表
bool portability_ext_available = false;
for (const auto& ext : extensions) {
    if (strcmp(ext.extensionName, VK_KHR_PORTABILITY_ENUMERATION_EXTENSION_NAME) == 0) {
        portability_ext_available = true;
        enabled_extensions.push_back(VK_KHR_PORTABILITY_ENUMERATION_EXTENSION_NAME);
        break;
    }
}

2. 给实例创建信息结构体添加Portability要求的创建标志：

instance_create_info.flags = VK_INSTANCE_CREATE_ENUMERATE_PORTABILITY_BIT_KHR;

3. 将实例创建信息中原来传入GLFW扩展列表的参数，替换为自定义组装的扩展列表：

instance_create_info.enabledExtensionCount = static_cast<uint32_t>(enabled_extensions.size());
instance_create_info.ppEnabledExtensionNames = enabled_extensions.data();

• 编译链接时不需要同时链接libvulkan.1.dylib和带具体版本号的libvulkan.1.3.216.dylib，仅保留libvulkan.1.dylib的链接即可，重复链接可能导致Loader符号解析异常。
• 如果后续枚举物理设备时出现设备识别异常，可以额外追加启用VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAME扩展，该扩展是Portability实现的常见依赖项。
• 升级到GLFW 3.4及以上版本后，库本身会在macOS平台自动检测并追加Portability相关扩展，不需要手动添加，但创建标志仍需自行配置。

内容的提问来源于stack exchange，提问作者Chribit