指定仅查找Framework时CMake仍检索/opt/homebrew下SDL2的问题

一、强制CMake使用/Library/Frameworks下的SDL2 Framework #

CMake优先匹配Homebrew版本的核心原因是其模块路径或前缀路径优先级更高，可通过以下方式强制指定Framework版本：

1. 直接在CMakeLists.txt中定位Framework
   跳过find_package(SDL2)，改用find_library直接锁定Framework路径：

   # 定位SDL2 Framework
   find_library(SDL2_LIBRARY SDL2
       PATHS /Library/Frameworks
       NO_DEFAULT_PATH  # 禁用默认路径搜索，避免匹配Homebrew版本
   )
   # 添加SDL2头文件路径
   include_directories(/Library/Frameworks/SDL2.framework/Headers)
   # 链接目标时直接使用Framework
   target_link_libraries(你的项目目标名 PRIVATE ${SDL2_LIBRARY})
   

2. 通过CMake命令行参数强制路径优先级
   配置时明确指定前缀路径为Framework目录，并清空Homebrew相关的模块搜索路径：

   rm -rf build && mkdir build && cd build
   cmake .. \
     -DCMAKE_FIND_FRAMEWORK=ONLY \
     -DCMAKE_OSX_ARCHITECTURES=x86_64 \
     -DCMAKE_PREFIX_PATH=/Library/Frameworks \
     -DCMAKE_MODULE_PATH=""  # 避免加载Homebrew的FindSDL2.cmake模块
   

3. 清理CMake缓存残留路径
   若之前的配置缓存已记录Homebrew路径，需手动删除缓存文件：

   rm -f build/CMakeCache.txt
   

二、解决"无法打开src_in-NOTFOUND"错误 #

该错误由CMake缓存残留或配置文件路径错误导致，解决步骤：

1. 彻底清理构建目录
   删除整个build目录，完全清除旧缓存：

   rm -rf build
   

2. 排查CMakeLists.txt中的路径问题
   检查配置文件是否存在以下情况：

   • 错误调用add_subdirectory(src_in)或include(src_in/xxx.cmake)，但该目录实际不存在
   • 变量引用错误，比如${SRC_IN_DIR}未正确定义却被使用
     修正后重新创建build目录并执行cmake配置。

三、编译通用二进制的最终步骤 #

当x86_64版本编译成功后，可直接通过CMake生成包含arm64和x86_64的通用二进制：

cmake .. \
  -DCMAKE_FIND_FRAMEWORK=ONLY \
  -DCMAKE_OSX_ARCHITECTURES="arm64;x86_64" \
  -DCMAKE_PREFIX_PATH=/Library/Frameworks
make

CMake会自动调用clang编译两个架构的目标文件，最终生成可直接部署的通用二进制程序。

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