MacOS ARM64平台CMake无法引入llvm/Support/Host.h的问题

在MacOS ARM64平台的C++项目中，已配置CMake引入LLVM，但其他LLVM头文件均可正常引入，唯独llvm/Support/Host.h找不到，导致调用llvm::sys::getDefaultTargetTriple()时出现符号解析错误。尝试通过Module->getTargetTriple()获取目标三元组，输出结果为空。

已尝试的CMake配置片段 #

find_package(LLVM REQUIRED CONFIG)

include_directories(${LLVM_INCLUDE_DIRS})
add_definitions(${LLVM_DEFINITIONS})

set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -L/opt/homebrew/opt/llvm/lib -Wl,-rpath,/opt/homebrew/opt/llvm/lib -lLLVM")

target_link_libraries(Vast PRIVATE ${LLVM_LIBRARIES})

include_directories(/opt/homebrew/opt/llvm/include)

规避尝试及结果 #

尝试通过Module获取目标三元组：

llvm::Triple triple(Module->getTargetTriple());

llvm::outs() << "Target triple: " << triple.str() << "\n";

输出结果为空：

Target triple: 

完整CMakeLists.txt #

cmake_minimum_required(VERSION 3.29)
project(Vast)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

#find_package(LLVM REQUIRED CONFIG)
#include_directories(${LLVM_INCLUDE_DIRS})
#add_definitions(${LLVM_DEFINITIONS})

add_executable(Vast
    cvast/main.cpp
)

find_package(LLVM REQUIRED CONFIG)

include_directories(${LLVM_INCLUDE_DIRS})
add_definitions(${LLVM_DEFINITIONS})

set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -L/opt/homebrew/opt/llvm/lib -Wl,-rpath,/opt/homebrew/opt/llvm/lib -lLLVM")

target_link_libraries(Vast PRIVATE ${LLVM_LIBRARIES})

#target_link_libraries(Vast PRIVATE ${LLVM_LIBRARIES})

include_directories(/opt/homebrew/opt/python@3.13/Frameworks/Python.framework/Versions/3.13/include/python3.13)

include_directories(/opt/homebrew/opt/llvm/include)

target_link_libraries(${PROJECT_NAME}
        /opt/homebrew/opt/python@3.13/Frameworks/Python.framework/Versions/3.13/lib/libpython3.13.dylib
)

target_include_directories(Vast PRIVATE /opt/homebrew/include)

编译错误信息 #

[1/2] Building CXX object CMakeFiles/Vast.dir/cvast/main.cpp.o
FAILED: CMakeFiles/Vast.dir/cvast/main.cpp.o 
/Library/Developer/CommandLineTools/usr/bin/c++  -I/opt/homebrew/opt/llvm/include -I/opt/homebrew/opt/python@3.13/Frameworks/Python.framework/Versions/3.13/include/python3.13 -isystem /opt/homebrew/include -g -std=gnu++20 -arch arm64 -isysroot /Library/Developer/CommandLineTools/SDKs/MacOSX15.2.sdk -fcolor-diagnostics   -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -D__STDC_LIMIT_MACROS -MD -MT CMakeFiles/Vast.dir/cvast/main.cpp.o -MF CMakeFiles/Vast.dir/cvast/main.cpp.o.d -o CMakeFiles/Vast.dir/cvast/main.cpp.o -c /Users/silicon/PycharmProjects/Vast/cvast/main.cpp
In file included from /Users/silicon/PycharmProjects/Vast/cvast/main.cpp:19:
In file included from /Users/silicon/PycharmProjects/Vast/cvast/headers/runner.h:14:
/Users/silicon/PycharmProjects/Vast/cvast/headers/irgen.h:27:10: fatal error: 'llvm/Support/Host.h' file not found
   27 | #include "llvm/Support/Host.h"
      |          ^~~~~~~~~~~~~~~~~~~~~
1 error generated.
ninja: build stopped: subcommand failed.

排查及解决要点 #

• CMake配置顺序错误：find_package(LLVM)必须在add_executable之前执行，否则LLVM_INCLUDE_DIRS等变量无法正确传递给目标编译选项。当前配置先创建可执行文件再查找LLVM，导致LLVM的头文件路径未被正确应用。
• 冗余路径干扰：手动添加/opt/homebrew/opt/llvm/include属于冗余操作，且无法弥补顺序错误带来的变量失效问题。
• LLVM组件依赖：llvm/Support/Host.h属于LLVM的Support组件，需确保${LLVM_LIBRARIES}包含该库，或显式链接LLVM::Support。
• 目标三元组为空的根源：Module默认未设置目标三元组，必须通过llvm::sys::getDefaultTargetTriple()先设置才能获取，而该函数依赖Host.h，因此解决头文件问题后即可正常获取三元组。

修正后的核心CMake配置示例 #

cmake_minimum_required(VERSION 3.29)
project(Vast)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 优先查找LLVM，确保变量生效
find_package(LLVM REQUIRED CONFIG)
include_directories(${LLVM_INCLUDE_DIRS})
add_definitions(${LLVM_DEFINITIONS})

# 再创建可执行文件
add_executable(Vast
    cvast/main.cpp
)

# 链接LLVM库（优先使用CMake变量，无需手动添加链接器参数）
target_link_libraries(Vast PRIVATE ${LLVM_LIBRARIES})

# Python依赖配置
include_directories(/opt/homebrew/opt/python@3.13/Frameworks/Python.framework/Versions/3.13/include/python3.13)
target_link_libraries(Vast PRIVATE /opt/homebrew/opt/python@3.13/Frameworks/Python.framework/Versions/3.13/lib/libpython3.13.dylib)

target_include_directories(Vast PRIVATE /opt/homebrew/include)

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