如何配置CMake不搜索系统路径，使用自定义编译的第三方库

我太懂这种头疼的情况了——明明指定了自定义库的路径，CMake却非要揪着系统安装的版本不放。针对你遇到的FFmpeg libswresample的问题，我整理了几个亲测有效的解决方法，一步步来：

1. 严格限制find_library的搜索范围 #

你的示例代码里已经用到了NO_DEFAULT_PATH，但可能参数不够完整，导致CMake还是偷偷去系统路径找。试试把find_library的参数补全，彻底锁死搜索范围：

set(FFMPEG_PATH "/shared/dev/libs/ffmpeg/3.4.2")

# 明确指定仅在自定义路径搜索，完全排除系统/环境路径
find_library(LIBSWRESAMPLE_LIB 
    NAMES swresample 
    PATHS ${FFMPEG_PATH}/lib/darwin-amd64 
    NO_DEFAULT_PATH 
    NO_CMAKE_ENVIRONMENT_PATH 
    NO_CMAKE_SYSTEM_PATH 
    NO_CMAKE_PATH
)

# 一定要加检查，确保找到的是自定义库，找不到直接报错
if(NOT LIBSWRESAMPLE_LIB)
    message(FATAL_ERROR "找不到自定义编译的swresample库，请检查路径：${FFMPEG_PATH}/lib/darwin-amd64")
endif()

# 链接时直接用找到的库文件，不要用库名（避免CMake又去系统找）
target_link_libraries(你的目标项目名称 PRIVATE ${LIBSWRESAMPLE_LIB})

这里的几个NO_*参数会彻底屏蔽CMake的默认搜索逻辑，只在你指定的PATHS里找，从根源上避免系统库干扰。

2. 提升自定义路径的搜索优先级 #

如果你的项目里要用到多个FFmpeg库（比如avcodec、avformat），一个个写find_library太麻烦，可以通过设置CMAKE_PREFIX_PATH让CMake优先搜索你的自定义库路径：

方法一：在CMakeLists.txt开头设置 #

set(FFMPEG_PATH "/shared/dev/libs/ffmpeg/3.4.2")
# 把自定义路径放到搜索列表最前面
set(CMAKE_PREFIX_PATH ${FFMPEG_PATH} ${CMAKE_PREFIX_PATH})

# 之后再用find_package或者find_library就会优先找自定义库
find_library(LIBSWRESAMPLE_LIB NAMES swresample)

方法二：运行CMake时通过命令行传递 #

这种方法不需要修改CMakeLists.txt，适合临时切换库版本：

rm -rf CMakeCache.txt CMakeFiles/  # 先清理旧缓存
cmake .. -DCMAKE_PREFIX_PATH="/shared/dev/libs/ffmpeg/3.4.2"

3. 屏蔽pkg-config的干扰 #

如果你的系统里装了pkg-config，它可能会指向系统默认的FFmpeg库，导致CMake被带偏。可以直接清空pkg-config的搜索路径，或者指定自定义库的pkgconfig路径：

set(FFMPEG_PATH "/shared/dev/libs/ffmpeg/3.4.2")
# 清空系统pkg-config的搜索路径，强制用自定义库的配置
set(ENV{PKG_CONFIG_PATH} "${FFMPEG_PATH}/lib/pkgconfig")

find_package(PkgConfig REQUIRED)
# 通过pkg-config找到自定义库，然后直接链接
pkg_check_modules(LIBSWRESAMPLE REQUIRED IMPORTED_TARGET swresample)
target_link_libraries(你的目标项目名称 PRIVATE PkgConfig::LIBSWRESAMPLE)

4. 直接指定库的绝对路径（终极方案） #

如果上面的方法都不管用，那就直接给CMake喂库的绝对路径，彻底跳过搜索逻辑：

set(FFMPEG_PATH "/shared/dev/libs/ffmpeg/3.4.2")
# 根据你的库类型选.a（静态库）或者.dylib（动态库）
set(LIBSWRESAMPLE_LIB "${FFMPEG_PATH}/lib/darwin-amd64/libswresample.dylib")

target_link_libraries(你的目标项目名称 PRIVATE ${LIBSWRESAMPLE_LIB})

这种方法虽然不够灵活，但胜在绝对可靠，适合路径固定的场景。

最后别忘了清理CMake缓存！ #

如果之前CMake已经找到过系统库，它会把结果存在缓存里，哪怕你改了配置也不会重新搜索。所以每次修改CMake配置后，一定要先删除CMakeCache.txt和CMakeFiles目录，再重新运行CMake。

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