如何将UnQLite库链接到我的CMake管理的C++项目？

find_library找不到UnQLite库的核心原因是：CMake的默认搜索路径里没有你编译生成的UnQLite库文件。以下是几种可行的解决办法：

方法一：给find_library指定库的搜索路径 #

假设你克隆并编译UnQLite后，库文件存放在../unqlite/build（相对于当前项目根目录），头文件在../unqlite/include，修改CMake中的UnQLite相关配置如下：

# 搜索UnQLite库，指定自定义路径
find_library(UNQLITE_LIBRARY NAMES unqlite
    PATHS ../unqlite/build  # 替换为你的UnQLite库实际所在路径
)

if (UNQLITE_LIBRARY)
    target_link_libraries(Gateway ${UNQLITE_LIBRARY})
    # 添加UnQLite头文件目录
    target_include_directories(Gateway PRIVATE ../unqlite/include)
else ()
    message(FATAL_ERROR "UNQLITE_LIBRARY not found")
endif ()

如果希望只在指定路径搜索，避免误匹配其他版本，可以加上NO_DEFAULT_PATH参数。

方法二：手动指定库和头文件路径 #

如果自动搜索仍失败，直接硬编码路径（适合本地开发场景）：

# 替换为你的UnQLite实际路径
set(UNQLITE_INCLUDE_DIR "../unqlite/include")
# 根据系统选择静态库或动态库，比如Linux下是libunqlite.a，Windows下是unqlite.lib
set(UNQLITE_LIBRARY "../unqlite/build/libunqlite.a")

# 添加头文件目录
target_include_directories(Gateway PRIVATE ${UNQLITE_INCLUDE_DIR})
# 链接库
target_link_libraries(Gateway ${UNQLITE_LIBRARY})

方法三：将UnQLite安装到系统默认路径 #

在UnQLite的编译目录下执行安装命令（需管理员权限）：

sudo make install

这会将库文件安装到/usr/local/lib，头文件安装到/usr/local/include，CMake的find_library就能自动找到库，无需额外配置。

额外注意事项 #

• 确认UnQLite已成功编译，生成了对应库文件（静态库后缀为.a，动态库为.so/.dll）
• Windows环境下，库文件名可能为unqlite.lib，需修改find_library的NAMES参数为unqlite.lib

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