CMake无法链接静态库libcpp_dotenv.a问题排查求助

我正在开发一个Discord Bot项目，相关文件结构如下：

include/
    cpp-dotenv/
        dotenv.h
lib/
    libcpp_dotenv.a
src/
CMakeLists.txt

我的简化版CMakeLists.txt内容为：

cmake_minimum_required(VERSION 3.15)
set(BOT_NAME "tavernbot")
project(${BOT_NAME})

aux_source_directory(src mainsrc)
link_directories(${CMAKE_CURRENT_SOURCE_DIR}/lib)
add_executable(
        ${BOT_NAME}
        ${mainsrc})

set(CMAKE_POSITION_INDEPENDENT_CODE ON)

target_include_directories(${BOT_NAME} PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}/include
        )

target_link_libraries(${BOT_NAME}
        cpp_dotenv
        )

编译时出现以下错误：

/usr/bin/ld: /mnt/e/my_bot/lib/libcpp_dotenv.a(dotenv.cpp.o): in function `dotenv::dotenv::operator[](std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&) const':
dotenv.cpp:(.text+0x24): undefined reference to `dotenv::getenv(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&)'
/usr/bin/ld: /mnt/e/my_bot/lib/libcpp_dotenv.a(dotenv.cpp.o): in function `dotenv::dotenv::load_dotenv(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&, bool, bool)':
dotenv.cpp:(.text+0x1e1): undefined reference to `dotenv::Parser::Parser()'
/usr/bin/ld: dotenv.cpp:(.text+0x1f6): undefined reference to `dotenv::Parser::parse(std::istream&, bool, bool)'
/usr/bin/ld: dotenv.cpp:(.text+0x220): undefined reference to `antlr4::tree::ParseTreeWalker::~ParseTreeWalker()'
/usr/bin/ld: /mnt/e/my_bot/lib/libcpp_dotenv.a(dotenv.cpp.o): in function `dotenv::Parser::~Parser()':
dotenv.cpp:(.text._ZN6dotenv6ParserD2Ev[_ZN6dotenv6ParserD5Ev]+0x1b): undefined reference to `antlr4::tree::ParseTreeWalker::~ParseTreeWalker()'
/usr/bin/ld: /mnt/e/my_bot/lib/libcpp_dotenv.a(dotenv.cpp.o): in function `dotenv::Parser::~Parser()':
dotenv.cpp:(.text._ZN6dotenv6ParserD0Ev[_ZN6dotenv6ParserD5Ev]+0x1b): undefined reference to `antlr4::tree::ParseTreeWalker::~ParseTreeWalker()'
collect2: error: ld returned 1 exit status
gmake[3]: *** [CMakeFiles/tavernbot.dir/build.make:134: tavernbot] Error 1
gmake[2]: *** [CMakeFiles/Makefile2:139: CMakeFiles/tavernbot.dir/all] Error 2
gmake[1]: *** [CMakeFiles/Makefile2:146: CMakeFiles/tavernbot.dir/rule] Error 2
gmake: *** [Makefile:169: tavernbot] Error 2

请问我的CMakeLists.txt配置存在哪些问题，原因是什么？

1. 缺少cpp-dotenv依赖的antlr4库链接 #

静态库不会自动递归链接其依赖的其他库。从错误信息看，libcpp_dotenv.a内部使用了antlr4的代码（如antlr4::tree::ParseTreeWalker相关函数），但你的CMake配置仅链接了cpp_dotenv，未添加antlr4库的链接指令，导致链接器找不到这些符号。

2. 现有libcpp_dotenv.a可能不完整 #

错误中出现的dotenv::getenv、dotenv::Parser相关未定义符号，说明你手上的静态库可能未包含cpp-dotenv的全部实现代码。比如cpp-dotenv的源码可能包含多个cpp文件（如parser.cpp等），编译静态库时只编译了dotenv.cpp，遗漏了其他必要文件。

3. CMAKE_POSITION_INDEPENDENT_CODE设置时机错误 #

你在add_executable之后才设置CMAKE_POSITION_INDEPENDENT_CODE ON，该选项对已创建的目标无效。若需要开启该特性，应在project指令之后、add_executable之前设置；或者针对目标单独设置：

set_target_properties(${BOT_NAME} PROPERTIES POSITION_INDEPENDENT_CODE ON)

注：该选项主要影响动态库编译，对于可执行程序并非必须。

4. link_directories的使用不够可靠 #

CMake推荐优先使用find_library或直接指定库的完整路径，而非link_directories，后者可能因路径搜索顺序问题导致链接错误。优化示例：

find_library(CPP_DOTENV_LIB cpp_dotenv PATHS ${CMAKE_CURRENT_SOURCE_DIR}/lib NO_DEFAULT_PATH)
target_link_libraries(${BOT_NAME} ${CPP_DOTENV_LIB})

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