Ubuntu 22.04下CMake无法找到ZSTD库的问题排查与解决

可能的原因 #

• 路径配置错误：你添加的CMAKE_MODULE_PATH指向/usr/local/lib/cmake/zstd，但CMake在Config模式下查找包时，默认会在CMAKE_PREFIX_PATH的lib/cmake/<包名>目录下搜索，而非直接在指定的子目录查找；另外，源码编译安装的ZSTD通常会将配置文件放在/usr/local/lib/cmake/ZSTD（大写目录名），而非小写的zstd，大小写不匹配会导致找不到文件。
• 两次安装的冲突：先通过apt安装的系统版ZSTD，其CMake配置文件可能存在于系统默认路径中，CMake优先搜索系统路径时，可能会找到不完整的配置文件，或者与源码安装的版本产生冲突。
• 文件名大小写不匹配：ZSTD源码安装生成的配置文件通常是ZSTDConfig.cmake（全大写），而CMake错误提示中查找的是ZstdConfig.cmake（首字母大写）或zstd-config.cmake（全小写），大小写不匹配会导致查找失败。

解决办法 #

1. 确认配置文件的实际位置 #

先通过命令查找ZSTD相关的CMake配置文件：

find /usr/local -name "*ZstdConfig.cmake" -o -name "*zstd-config.cmake" -o -name "*ZSTDConfig.cmake"

根据输出结果确认配置文件的准确路径，比如可能是/usr/local/lib/cmake/ZSTD/ZSTDConfig.cmake。

2. 调整CMakeLists.txt的路径配置 #

• 方法一：添加前缀路径
  如果配置文件在/usr/local/lib/cmake/ZSTD下，无需指定CMAKE_MODULE_PATH，只需将/usr/local加入CMAKE_PREFIX_PATH，CMake会自动搜索该前缀下的包配置目录：

list(APPEND CMAKE_PREFIX_PATH "/usr/local")
find_package(ZSTD REQUIRED)

• 方法二：直接指定配置路径
  如果配置文件确实在/usr/local/lib/cmake/zstd下，可直接在find_package中指定路径：

find_package(ZSTD REQUIRED CONFIG PATHS "/usr/local/lib/cmake/zstd")

3. 解决版本冲突 #

如果不需要系统apt安装的ZSTD，可先卸载避免冲突：

sudo apt-get remove --purge zstd

卸载后重新运行CMake，确保优先使用源码安装的版本。

4. 强制指定配置文件路径 #

如果上述方法都无效，可直接指定配置文件的绝对路径：

find_package(ZSTD REQUIRED CONFIG FILE "/usr/local/lib/cmake/zstd/ZSTDConfig.cmake")

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