CMake编译顺序问题：ANTLR4 Runtime库链接失败需二次编译

问题根源很明确：CMake的**配置阶段（configure）**会执行find_library查找库文件，但此时ANTLR4 Runtime还没编译，库文件不存在，导致第一次生成的构建脚本里库路径是NOTFOUND；二次编译时配置阶段能找到已生成的库，所以成功。下面是几种靠谱的解决办法：

方案1：直接链接ANTLR4子项目的CMake目标（推荐） #

当你用add_subdirectory引入ANTLR4 Runtime源码后，CMake会自动创建对应的构建目标（比如动态库目标antlr4_shared，静态库目标antlr4_static），直接用这些目标链接，CMake会自动处理依赖顺序，确保ANTLR4先编译完成。

步骤：

1. 根目录CMakeLists.txt保持add_subdirectory(third_party)（确保third_party里的ANTLR4被正确引入）
2. 在src目录的CMakeLists.txt中，替换find_library的逻辑，直接链接目标：

# 替换原来的find_library和手动链接逻辑
target_link_libraries(parser_obj PRIVATE antlr4_shared)
# 如果用静态库就换成antlr4_static

这种方式不需要手动指定库路径，CMake会自动处理跨平台的库后缀、路径问题，同时严格保证依赖编译顺序，从根本上避免问题。

方案2：强制依赖顺序+指定查找路径 #

如果必须保留find_library的用法，需要让parser_obj明确依赖ANTLR4的构建目标，同时指定准确的查找路径：

1. 根目录CMakeLists.txt中确保ANTLR4子项目被正确引入：

add_subdirectory(third_party/antlr4-runtime) # 假设ANTLR4放在third_party/antlr4-runtime下

2. 在src目录的CMakeLists.txt中：

# 指定ANTLR4库的输出路径（CMake会把编译好的库放在CMAKE_BINARY_DIR/lib下）
set(ANTLR4_LIB_DIR "${CMAKE_BINARY_DIR}/lib")

# 强制parser_obj依赖ANTLR4的构建目标，确保先编译ANTLR4
add_dependencies(parser_obj antlr4_shared)

# 精准查找库文件，跳过系统默认路径
find_library(ANTLR4_LIB 
    NAMES antlr4-runtime
    PATHS ${ANTLR4_LIB_DIR}
    NO_DEFAULT_PATH
)

# 链接库
target_link_libraries(parser_obj PRIVATE ${ANTLR4_LIB})

注意：不同平台的库后缀不同，Windows是.lib，macOS是.dylib，Linux是.so，find_library会自动匹配对应平台的后缀，不用手动修改。

方案3：用ExternalProject_Add预编译ANTLR4 #

如果需要更严格的依赖控制，可以用ExternalProject_Add在CMake配置阶段就完成ANTLR4的编译，确保find_library执行时库已经存在：

include(ExternalProject)

ExternalProject_Add(
    antlr4_runtime
    SOURCE_DIR "${CMAKE_SOURCE_DIR}/third_party/antlr4-runtime"
    BINARY_DIR "${CMAKE_BINARY_DIR}/third_party/antlr4-runtime"
    CMAKE_ARGS -DCMAKE_INSTALL_PREFIX=${CMAKE_BINARY_DIR}/antlr4_install
    BUILD_COMMAND make # Windows下换成nmake或者msbuild，可通过CMAKE_GENERATOR自动适配
    INSTALL_COMMAND make install
)

# 安装完成后再查找库
ExternalProject_Get_Property(antlr4_runtime INSTALL_DIR)
find_library(ANTLR4_LIB 
    NAMES antlr4-runtime
    PATHS "${INSTALL_DIR}/lib"
    NO_DEFAULT_PATH
)

# 链接时依赖antlr4_runtime目标
add_dependencies(parser_obj antlr4_runtime)
target_link_libraries(parser_obj PRIVATE ${ANTLR4_LIB})

这种方式会在CMake配置阶段就编译并安装ANTLR4，彻底解决库文件不存在的问题，但配置相对复杂，适合多平台复杂依赖场景。

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