如何在CMake中设置构建阶段可被识别的环境变量？

问题原因 #

set(ENV{VAR}) 仅修改当前 CMake 配置进程运行时的环境变量，配置阶段结束后 CMake 进程退出，修改不会被写入生成的 Xcode 构建文件中，因此构建/运行阶段无法读取到对应值。

可行解决方案 #

方案1：直接配置Xcode Scheme环境变量（推荐）

CMake 3.25及以上版本提供了CMAKE_XCODE_SCHEME_ENVIRONMENT内置变量，可以直接将环境变量写入生成的Xcode项目Scheme配置中，完全替代手动修改的操作：

set(CMAKE_XCODE_SCHEME_ENVIRONMENT
    "VK_ICD_FILENAMES=/Users/username/VulkanSDK/macOS/share/vulkan/icd.d/MoltenVK_icd.json"
    "VK_LAYER_PATH=/Users/username/VulkanSDK/macOS/share/vulkan/explicit_layer.d"
)

配置后重新生成Xcode项目，对应变量会自动出现在Scheme的环境变量列表中。

方案2：为指定目标设置运行/测试环境变量

如果仅需要特定目标运行时读取这些环境变量，可以给目标设置ENVIRONMENT属性：

# 替换your_target_name为你实际的目标名
set_target_properties(your_target_name PROPERTIES
    ENVIRONMENT "VK_ICD_FILENAMES=/Users/username/VulkanSDK/macOS/share/vulkan/icd.d/MoltenVK_icd.json;VK_LAYER_PATH=/Users/username/VulkanSDK/macOS/share/vulkan/explicit_layer.d"
)

方案3：为构建阶段的自定义命令设置环境变量

如果是编译/链接等构建流程中的自定义命令需要读取这些变量，可以在命令前通过cmake -E env注入环境变量：

add_custom_command(TARGET your_target_name PRE_BUILD
    COMMAND ${CMAKE_COMMAND} -E env
        VK_ICD_FILENAMES=/Users/username/VulkanSDK/macOS/share/vulkan/icd.d/MoltenVK_icd.json
        VK_LAYER_PATH=/Users/username/VulkanSDK/macOS/share/vulkan/explicit_layer.d
        # 替换为实际需要执行的构建命令
        your_build_command
)

优化建议 #

可以通过find_package(Vulkan REQUIRED)自动获取Vulkan SDK的路径，避免硬编码本地用户名路径，提升项目可移植性。

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