g++链接时提示找不到已存在的antlr4-runtime库是什么原因？

问题根本原因 #

你错误使用了g++的链接参数规则：
-l（小写L）参数的设计是仅接受去掉前缀lib、去掉后缀.so/.a的精简库名，不支持直接传入库的完整路径。当你执行-l/antlr4/runtime/Cpp/dist/libantlr4-runtime.so.4.9.3时，链接器会把整段路径当成库名，自动在前后拼接lib前缀和.so后缀，去系统默认搜索路径下查找完全不存在的目标文件，因此抛出找不到库的错误。

解决方案 #

方案1：指定搜索路径+短库名链接（生产环境推荐） #

先通过-L参数将动态库所在目录加入链接器的搜索路径，再用-l传入精简后的库名即可完成链接：

g++ *.o -L/antlr4/runtime/Cpp/dist -lantlr4-runtime

如果运行程序时提示找不到动态库，可临时配置环境变量指定运行时库搜索路径：

export LD_LIBRARY_PATH=/antlr4/runtime/Cpp/dist:$LD_LIBRARY_PATH
./生成的可执行文件名

如需永久生效，可将库路径写入/etc/ld.so.conf.d/下的自定义配置文件，执行ldconfig刷新系统库缓存即可。

方案2：直接传入完整库路径（临时测试适用） #

不需要加-l参数，直接把动态库的完整路径当成普通输入文件传给g++即可：

g++ *.o /antlr4/runtime/Cpp/dist/libantlr4-runtime.so.4.9.3

该方式链接的程序运行时会直接使用你指定的完整路径查找库，无需额外配置环境变量。

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