Windows10下使用antlr4-4.9.2构建C++项目出现符号歧义报错

核心问题1：缺少必要的编译宏定义 #

Windows平台下编译ANTLR4 C++静态运行时必须指定专属编译宏，你当前的配置完全没有添加相关宏，会导致大量编译错误与警告，同时也会引发标识符匹配异常。

核心问题2：头文件包含路径配置缺失 #

你仅将运行时的cpp文件加入编译，没有为运行时库、你的项目目标指定ANTLR4运行时的头文件搜索路径，编译器搜索TokenSource这类标识符时会匹配到其他命名空间/头文件中的同名定义，直接触发歧义报错。

核心问题3：可选优化项（非报错直接诱因） #

直接用file(GLOB)匹配源码文件不会主动感知新增/删除的文件，修改后需要手动重新生成CMake缓存才会生效，后续可以考虑显式指定源码文件避免该问题。

修正后的CMake配置参考 #

file(GLOB antlr4-cpp-src
    third_party/antlr4-cpp-runtime-4.9.2/src/*.cpp
    third_party/antlr4-cpp-runtime-4.9.2/src/atn/*.cpp
    third_party/antlr4-cpp-runtime-4.9.2/src/dfa/*.cpp
    third_party/antlr4-cpp-runtime-4.9.2/src/misc/*.cpp
    third_party/antlr4-cpp-runtime-4.9.2/src/support/*.cpp
    third_party/antlr4-cpp-runtime-4.9.2/src/tree/*.cpp
    third_party/antlr4-cpp-runtime-4.9.2/src/tree/pattern/*.cpp
    third_party/antlr4-cpp-runtime-4.9.2/src/tree/xpath/*.cpp
)
add_library (antlr4-cpp-runtime ${antlr4-cpp-src})
# 新增：为antlr运行时库指定头文件路径、编译宏
target_include_directories(antlr4-cpp-runtime PUBLIC third_party/antlr4-cpp-runtime-4.9.2/src)
target_compile_definitions(antlr4-cpp-runtime PUBLIC 
    ANTLR4CPP_STATIC 
    _CRT_SECURE_NO_WARNINGS
)
add_executable(MiniSql ${src_dir} src/main.cpp)
target_link_libraries(MiniSql antlr4-cpp-runtime)

额外排查点 #

如果按照上述配置修改后仍然有歧义报错，检查你的业务代码：

• 是否同时使用了using namespace antlr4;和其他包含同名TokenSource定义的命名空间，避免在全局范围使用using namespace导入多个命名空间
• 若确有同名冲突，可在ANTLR相关代码中显式指定命名空间前缀antlr4::TokenSource解决歧义

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