如何在Windows下通过CMake静态链接ANTLR4 C++运行时库（无需依赖DLL）

嘿，我碰到过好多次这个坑了——明明在CMake里声明了要静态链接ANTLR4的C++运行时，结果程序一跑就提示缺antlr-runtime.dll，其实核心问题出在两个地方：你用的.lib文件可能根本不是静态库，还有CMake的配置没补全细节。

第一步：先确认你拿到的是真·ANTLR4静态库 #

Windows下的.lib文件分两种：一种是动态库的导入库（说白了就是个指向.dll的“快捷方式”），另一种才是真正的静态库。你当前用的antlr4-runtime.lib大概率是前者，这就导致哪怕你写了STATIC IMPORTED，链接器还是会生成依赖dll的程序。

怎么确认？

• 如果是下载预编译包，别选普通的win32包，找带static标识的（比如antlr4-cpp-runtime-xxx-win32-static.zip这类）；
• 如果是自己编译ANTLR4 runtime，CMake配置时一定要开ANTLR4_BUILD_STATIC选项，编译出来的antlr4-runtime.lib才是纯静态库。

第二步：修正CMakeLists.txt的静态库导入配置 #

你现有的代码只设置了IMPORTED_LOCATION，对于MSVC的静态库，还得明确库的类型，同时要保证你的程序和ANTLR4用的是同一种CRT（运行时库），不然容易出问题。给你改好的代码：

# 导入ANTLR4静态库，加GLOBAL是为了让所有目标都能引用到
add_library(antlr_runtime_lib STATIC IMPORTED GLOBAL)

if(MSVC)
    # 替换成你实际的静态库路径
    set(ANTLR_STATIC_LIB "$ENV{ANTLR4_LIB_DIR}/antlr4-runtime.lib")
    set_target_properties(antlr_runtime_lib PROPERTIES
        IMPORTED_LOCATION "${ANTLR_STATIC_LIB}"
        # 明确告诉CMake这是C++静态库，避免误判
        IMPORTED_LINK_INTERFACE_LANGUAGES "CXX"
    )

    # 关键：确保你的程序和ANTLR4用相同的CRT
    # 比如ANTLR4用静态CRT编译的，那你的程序也要用/MT（Release）或/MTd（Debug）
    target_compile_options(antlr_runtime_lib INTERFACE
        $<$<CONFIG:Release>:/MT>
        $<$<CONFIG:Debug>:/MTd>
    )
elseif(UNIX)
    # Unix下的静态库是.a文件，配置相对简单
    set_target_properties(antlr_runtime_lib PROPERTIES
        IMPORTED_LOCATION "$ENV{ANTLR4_LIB_DIR}/libantlr4-runtime.a"
    )
endif()

# 把你的目标程序和ANTLR静态库链接起来
target_link_libraries(你的目标程序名称 PRIVATE antlr_runtime_lib)

最后再检查两个关键点 #

1. 验证.lib类型：用Visual Studio自带的dumpbin工具，在命令行跑dumpbin /headers antlr4-runtime.lib，如果输出里有DLL相关字样，那肯定是动态导入库，赶紧换静态版本；
2. 别混链动态库：检查你的CMake配置里，有没有不小心同时链接了动态版本的ANTLR库，比如有没有其他地方写了antlr4-runtime的动态库导入代码。

按这个步骤改完，重新构建你的程序，应该就能生成完全不依赖antlr-runtime.dll的可执行文件了。

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