无法链接GLUT：CMake链接报错排查求助

我在CMake文件中写入了以下指令：

# GLUT
find_package(GLUT REQUIRED)
target_link_libraries(${OutputExecutable} ${GLUT_LIBRARIES})

执行CMake配置无报错，但编译时出现链接错误：

ld: library not found for -lglut
clang: error: linker command failed with exit code 1 (use -v to see invocation)

已通过brew安装GLUT（实际是Freeglut），执行pkg-config --libs glut返回正常路径：

-L/usr/local/Cellar/freeglut/3.4.0/lib -lglut

查看CMake缓存文件也能看到该路径，环境为OSX Big Sur(11.6.5)、CMake 3.22。怀疑是系统自带的/System/Library/Frameworks/GLUT.framework与brew安装的Freeglut冲突导致链接失败。

• 强制CMake通过pkg-config定位Freeglut
  在find_package(GLUT)前添加配置，让CMake优先使用pkg-config获取Freeglut信息，跳过默认的系统框架查找逻辑：

  set(GLUT_USE_FRAMEWORK OFF)
  find_package(PkgConfig REQUIRED)
  pkg_check_modules(GLUT REQUIRED glut)
  

  链接时改用pkg-config提供的变量：

  target_link_libraries(${OutputExecutable} ${GLUT_LINK_LIBRARIES})
  

• 直接指定Freeglut的安装路径
  如果pkg-config方式仍有问题，可以直接硬编码Freeglut的头文件和库路径（路径可通过brew info freeglut确认）：

  set(FREEGLUT_INCLUDE_DIR "/usr/local/Cellar/freeglut/3.4.0/include")
  set(FREEGLUT_LIBRARY "/usr/local/Cellar/freeglut/3.4.0/lib/libglut.dylib")
  target_include_directories(${OutputExecutable} PRIVATE ${FREEGLUT_INCLUDE_DIR})
  target_link_libraries(${OutputExecutable} ${FREEGLUT_LIBRARY})
  

• 调整CMake框架查找优先级
  在CMake脚本开头设置变量，让CMake优先查找普通动态库，再考虑系统框架：

  set(CMAKE_FIND_FRAMEWORK LAST)
  

• 验证链接命令参数
  编译时添加VERBOSE=1查看完整链接命令，确认Freeglut的库路径是否被正确加入：

  make VERBOSE=1
  

  如果-L/usr/local/Cellar/freeglut/3.4.0/lib未出现在参数中，需要检查CMake变量的传递是否存在问题。

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