CMake与FLTK安装关联脆弱？Mac环境项目构建故障排查

问题现象 #

原项目目录/Users/ken/vsc/catch可正常构建，但完整复制到/Users/ken/prog24/Catchwater后构建失败：

• 编译器找不到#include <FL/Fl.H>
• CMake的find_package(FLTK REQUIRED)无法定位该包
• 已确认FLTK头文件存在于/opt/homebrew/Cellar/fltk/1.3.9/include/FL，但/opt/homebrew/include下无对应软链路径

相关细节 #

1. 找到多个FindFLTK.cmake文件：
   • /opt/homebrew/Cellar/cmake/3.29.4/share/cmake/Modules/FindFLTK.cmake
   • /usr/local/Cellar/cmake/3.28.1/share/cmake/Modules/FindFLTK.cmake（两者内容一致）
   • Matlab应用包中也存在该文件，疑惑CMake是否会检索这些路径
2. 环境信息：CMake 3.29.4，MacOS 14.2.1

项目CMakeLists.txt内容 #

cmake_minimum_required(VERSION 3.5)
project(Catchwater)

set(CMAKE_PREFIX_PATH  "\"/opt/homebrew\"")
find_package(FLTK REQUIRED)
include_directories(${FLTK_INCLUDE_DIRS} .  ./FromGLOW ./Pipeworks ./fluidSim ./common /opt/homebrew/include)
link_directories(${FLTK_LIBRARY_DIRS})

find_library(GLUT GLUT)
if (NOT GLUT)
    message(FATAL_ERROR "\"GLUT is missing\"")
endif() 

message(STATUS FLTK_INCLUDE_DIRS=${FLTK_INCLUDE_DIRS})

add_executable(Catchwater 
    Pipeworks/main.cpp Pipeworks/Catchwater.cpp Pipeworks/Flow.cpp Pipeworks/PipeType.cpp 
    Pipeworks/Text.cpp Pipeworks/fltkbasicgl.cpp Pipeworks/Spherical.cpp
    fluidSim/fluidSolver.cpp fluidSim/ fluidSim/particle.cpp fluidSim/sceneGrid.cpp 
    fluidSim/surface.cpp  fluidSim/triBoxOverlap.cpp  
    common/Tools.cpp common/V3.cpp common/quat.cpp common/Matrix.cpp common/mat16fv.cpp 
    common/vec3fv.cpp common/vec4fv.cpp fromGLOW/glowVectorAlgebra.cpp )

add_compile_definitions(GL_SILENCE_DEPRECATION)
target_compile_options(Catchwater PRIVATE -Wno-deprecated-declarations -Wno-writable-strings -Wno-return-type -Wno-parentheses)
target_compile_features(Catchwater PUBLIC cxx_std_11)
target_link_libraries(Catchwater ${FLTK_LIBRARIES} ${GLUT})

CMake配置输出（VSCode CMake Tools扩展） #

[main] Configuring project: Catchwater 
[proc] Executing command: /opt/homebrew/bin/cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Debug -DCMAKE_EXPORT_COMPILE_COMMANDS:BOOL=TRUE -S/Users/ken/prog24/Catchwater -B/Users/ken/prog24/Catchwater/build -G "\"Unix Makefiles\""
[cmake] Not searching for unused variables given on the command line.
[cmake] -- FLTK_INCLUDE_DIRS=
[cmake] -- Configuring done (0.2s)
[cmake] -- Generating done (0.0s)
[cmake] -- Build files have been written to: /Users/ken/prog24/Catchwater/build

排查与解决方案 #

1. 修复FLTK的Homebrew软链问题 #

Homebrew默认会将Cellar中的软件文件软链到/opt/homebrew/include、/opt/homebrew/lib等公共路径，当前缺失软链属于安装不完整，执行以下命令重新安装FLTK：

brew reinstall fltk

安装完成后检查/opt/homebrew/include/FL是否存在，确认软链创建成功。

2. 修正CMakeLists.txt的路径错误 #

当前set(CMAKE_PREFIX_PATH)语句中多了转义双引号，导致CMake无法识别正确路径，修改为：

set(CMAKE_PREFIX_PATH "/opt/homebrew")

3. 关于FindFLTK.cmake的检索路径 #

CMake默认只会检索自身安装目录下的Modules文件夹（即/opt/homebrew/Cellar/cmake/3.29.4/share/cmake/Modules），以及通过CMAKE_MODULE_PATH指定的路径，Matlab中的FindFLTK.cmake不会被自动检索，无需处理。

4. /usr/local/Cellar路径的处理 #

对于Apple Silicon架构的Mac，Homebrew默认安装路径为/opt/homebrew，/usr/local/Cellar是Intel架构下的旧路径：

• 若当前已完全切换到/opt/homebrew的Homebrew，且无依赖旧路径的软件，可以清理该目录
• 清理前可先确认旧Homebrew是否卸载：执行/usr/local/bin/brew --version，若返回不存在则已卸载，直接删除/usr/local/Cellar即可
• 若仍有Intel版软件依赖，建议保留，或逐步迁移到Apple Silicon版本

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