使用CMake FetchContent时，如何优先使用本地已安装的软件包？

核心问题解决方法 #

你原来的代码不管本地有没有安装都走Git下载，是因为FIND_PACKAGE_ARGS的触发逻辑可能没正确识别到本地的pkg-dev包（比如包的CMake配置文件不符合查找规则）。更可靠的方式是手动先尝试查找本地包，找不到再用FetchContent下载，代码示例如下：

# 先静默查找本地已安装的pkg包，不强制要求存在
find_package(pkg QUIET)

# 如果本地没找到，再通过FetchContent远程下载构建
if(NOT pkg_FOUND)
  FetchContent_Declare(
    pkg
    GIT_REPOSITORY sth
    GIT_TAG        sth
  )
  FetchContent_MakeAvailable(pkg)
endif()

这种方式会优先使用apt安装的本地版本，只有当本地确实没安装时，才会触发远程下载，完美满足你的需求。

延伸问题解答 #

如果用locate能在/usr/lib、/usr/include找到包，但CMake的find_package识别不到，说明这个包没有提供符合CMake查找规范的配置文件（比如缺少.pc文件、*Config.cmake文件等）。这种情况下：

• 不需要把它加入FetchContent配置，因为本地已经有现成的二进制安装包
• 你可以手动用find_library和find_path指定路径查找，然后把找到的路径添加到项目的包含目录和链接库中，示例代码：

# 手动查找库文件和头文件
find_library(PKG_LIB NAMES pkg PATHS /usr/lib)
find_path(PKG_INCLUDE NAMES pkg.h PATHS /usr/include)

# 确保找到后再添加到项目
if(PKG_LIB AND PKG_INCLUDE)
  include_directories(${PKG_INCLUDE})
  target_link_libraries(你的项目名 PRIVATE ${PKG_LIB})
else()
  # 没找到的话再走FetchContent下载
  FetchContent_Declare(
    pkg
    GIT_REPOSITORY sth
    GIT_TAG        sth
  )
  FetchContent_MakeAvailable(pkg)
endif()

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