Apple Silicon Mac使用MoltenVK时Vulkan层库加载失败求助

问题根源 #

Apple Silicon Mac的/usr/local目录默认是Rosetta（x86_64）环境的路径，而你安装的arm64版本Vulkan SDK库并不在这个路径下，导致验证层尝试从错误的位置加载库文件。

解决方案 #

1. 配置Xcode Scheme的环境变量

   • 打开项目的Scheme设置：Product > Scheme > Edit Scheme
   • 切换到Run > Arguments > Environment Variables，添加/修改以下变量：
     • VK_LAYER_PATH：设置为你的Vulkan SDK explicit_layer.d路径：/Users/jakub/VulkanSDK/1.3.224.1/macOS/share/vulkan/explicit_layer.d
     • VK_ICD_FILENAMES：设置为MoltenVK的ICD配置路径：/Users/jakub/VulkanSDK/1.3.224.1/macOS/share/vulkan/icd.d/MoltenVK_icd.json
     • 移除错误的VK_INSTANCE_LAYERS手动配置，Khronos验证层已包含api_dump等功能，只需启用VK_LAYER_KHRONOS_validation即可

2. 验证库文件路径与架构

   • 检查SDK的lib目录，确认libVkLayer_khronos_validation.dylib存在于/Users/jakub/VulkanSDK/1.3.224.1/macOS/lib
   • 用以下命令确认库支持arm64架构：

     lipo -info /Users/jakub/VulkanSDK/1.3.224.1/macOS/lib/libVkLayer_khronos_validation.dylib
     

3. 清理并重启Xcode

   • 执行Product > Clean Build Folder清理构建缓存
   • 重启Xcode，确保环境变量生效

4. 命令行测试（可选）
   如果Xcode仍有问题，先在终端中测试验证层是否正常工作：

   export VK_LAYER_PATH=/Users/jakub/VulkanSDK/1.3.224.1/macOS/share/vulkan/explicit_layer.d
   export VK_ICD_FILENAMES=/Users/jakub/VulkanSDK/1.3.224.1/macOS/share/vulkan/icd.d/MoltenVK_icd.json
   ./你的可执行文件路径
   

   若命令行正常运行，说明Xcode的Scheme环境变量配置未正确应用，需检查变量是否拼写正确、是否勾选了Pass Environment Variables选项

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