CMake如何忽略标准头文件路径？自定义libsodium库调用问题

你的问题核心在于find_path的参数用错了——PATH_SUFFIXES是用来指定路径后缀的（比如在指定的PATHS下再找子目录），而不是直接放完整的自定义路径。这就导致CMake还是优先去系统默认路径里找sodium.h了。

下面给你几个靠谱的解决方案，按优先级排序：

方案1：直接指定自定义路径并跳过系统默认路径 #

最直接的方式是明确告诉CMake自定义libsodium的位置，并且强制它只在这个路径下查找，避免系统库干扰：

# 定义自定义libsodium的根目录
set(CUSTOM_SODIUM_ROOT "${PROJECT_SOURCE_DIR}/.libs/sodium")

# 查找头文件：直接指定自定义include目录，跳过系统默认路径
find_path(SODIUM_INCLUDE_DIR
  NAMES sodium.h
  PATHS "${CUSTOM_SODIUM_ROOT}/include"
  NO_DEFAULT_PATH  # 关键：完全跳过系统默认的查找路径
)

# 查找库文件：同理指定自定义lib目录（如果是64位系统可能是lib64，根据你的编译结果调整）
find_library(SODIUM_LIBRARY
  NAMES sodium
  PATHS "${CUSTOM_SODIUM_ROOT}/lib"
  NO_DEFAULT_PATH
)

# 验证并使用找到的库
if(SODIUM_INCLUDE_DIR AND SODIUM_LIBRARY)
  message(STATUS "✅ Found custom libsodium include path: ${SODIUM_INCLUDE_DIR}")
  message(STATUS "✅ Found custom libsodium library: ${SODIUM_LIBRARY}")
  
  # 给目标添加头文件目录和链接库
  include_directories(${SODIUM_INCLUDE_DIR})
  target_link_libraries(你的项目目标名称 PRIVATE ${SODIUM_LIBRARY})
else()
  message(FATAL_ERROR "❌ Custom libsodium not found! Check your path: ${CUSTOM_SODIUM_ROOT}")
endif()

方案2：优先自定义路径，找不到再用系统库 #

如果你想保留“自定义库优先，找不到再降级用系统库”的逻辑，可以去掉NO_DEFAULT_PATH，换成NO_CMAKE_SYSTEM_PATH（跳过CMake默认的系统路径，但保留你手动指定的路径优先级）：

set(CUSTOM_SODIUM_ROOT "${PROJECT_SOURCE_DIR}/.libs/sodium")

find_path(SODIUM_INCLUDE_DIR
  NAMES sodium.h
  PATHS "${CUSTOM_SODIUM_ROOT}/include"
  NO_CMAKE_SYSTEM_PATH  # 优先自定义路径，找不到再去系统默认路径找
)

find_library(SODIUM_LIBRARY
  NAMES sodium
  PATHS "${CUSTOM_SODIUM_ROOT}/lib"
  NO_CMAKE_SYSTEM_PATH
)

# 如果自定义路径没找到，再去系统找
if(NOT SODIUM_INCLUDE_DIR)
  find_path(SODIUM_INCLUDE_DIR NAMES sodium.h)
endif()
if(NOT SODIUM_LIBRARY)
  find_library(SODIUM_LIBRARY NAMES sodium)
endif()

方案3：通过CMAKE_PREFIX_PATH全局指定 #

你也可以在调用CMake的时候，通过命令行参数把自定义libsodium的路径设为优先查找目录：

cmake .. -DCMAKE_PREFIX_PATH="${PROJECT_SOURCE_DIR}/.libs/sodium"

这样CMake会自动先在这个前缀路径下找include和lib目录，不用改CMakeLists.txt里的查找逻辑。

额外小提示 #

如果你是自己编译libsodium，建议编译时指定安装前缀到你的自定义目录，这样文件结构会更规范：

cd libsodium-source-dir
./configure --prefix="${PROJECT_SOURCE_DIR}/.libs/sodium"
make && make install

这样头文件会自动放到include目录，库文件放到lib目录，CMake查找起来更顺畅。

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