如何为Tesseract正确编写CMakeLists.txt以解决链接错误？

核心思路 #

CMake的target_link_libraries遵循依赖顺序：被依赖的库要放在依赖它的库后面。Tesseract依赖Leptonica，若代码同时用到libcurl，需把libcurl放在合适位置，或用CMake模块自动处理依赖链。

完整配置示例 #

# 最低CMake版本要求
cmake_minimum_required(VERSION 3.10)

# 项目名称
project(tesseract_curl_demo)

# 设置C++标准
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 查找依赖库
# 查找Leptonica
find_package(Leptonica REQUIRED)
# 查找Tesseract（若CMake找不到，需手动指定库所在的cmake目录路径）
find_package(Tesseract REQUIRED)
# 查找libcurl
find_package(CURL REQUIRED)

# 添加可执行文件
add_executable(demo your_source_file.cpp)

# 链接依赖库：遵循依赖顺序，Tesseract依赖Leptonica，Leptonica在前；代码依赖Tesseract和curl，按需求排列
target_link_libraries(demo
    PRIVATE
        ${Tesseract_LIBRARIES}
        ${Leptonica_LIBRARIES}
        ${CURL_LIBRARIES}
)

# 包含头文件目录
target_include_directories(demo
    PRIVATE
        ${Tesseract_INCLUDE_DIRS}
        ${Leptonica_INCLUDE_DIRS}
        ${CURL_INCLUDE_DIRS}
)

关键注意事项 #

• 用find_package自动处理依赖：不要手动写-lcurl或-ltesseract，CMake的find_package会自动处理库路径和链接顺序，避免手动指定导致的顺序错误。
• target_link_libraries的顺序规则：若必须手动指定库名（比如find_package找不到的情况），要遵循依赖者在后，被依赖者在前。比如代码调用Tesseract和curl，Tesseract依赖Leptonica，顺序应为：可执行文件 -> tesseract -> leptonica -> curl（curl无额外依赖时）。
• 指定库的安装路径：如果find_package找不到Tesseract或Leptonica，可在CMake命令行手动指定路径，示例：

  cmake .. -DTesseract_DIR=/path/to/tesseract/lib/cmake/Tesseract -DLeptonica_DIR=/path/to/leptonica/lib/cmake/Leptonica
  

• 避免全局链接：不要用link_libraries全局链接，而是用target_link_libraries针对具体目标链接，逻辑更清晰，也不易出现顺序问题。

常见问题排查 #

• 若仍出现archive相关未定义引用，可能是Leptonica或Tesseract依赖zlib、libpng等库，find_package通常会自动处理这些依赖，若未处理，需手动将对应库添加到target_link_libraries中。
• 确保系统已正确安装所有依赖库的开发包（比如libtesseract-dev、libleptonica-dev、libcurl4-openssl-dev等）。

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