M1芯片Mac使用CMake运行arm64版SFML项目出现链接错误如何解决？

核心错误原因 #

你遇到的Undefined symbols报错由以下三个配置问题共同导致：

1. CMAKE_OSX_ARCHITECTURES是CMake全局架构配置变量，不能写入CMAKE_CXX_FLAGS中，且必须放在project指令之前才会生效
2. 你下载的arm64版SFML默认使用苹果Clang编译，而你强制指定了Homebrew的g++-11作为编译器，二者C++标准库ABI不兼容，导致SFML导出的符号无法被GCC编译的目标文件识别
3. 你将SFML放在~/Library/Frameworks路径下，但CMake配置中没有指定该框架搜索路径，还错误添加了Intel架构专属的/usr/local/include头文件搜索路径

修复步骤 #

• 优先使用苹果自带Clang作为编译器（与预编译SFML ABI兼容），删除强制指定g++-11的配置。如果必须使用GCC，需要自行用对应GCC版本重新编译SFML源码，避免ABI不兼容问题
• 修正架构变量配置，将CMAKE_OSX_ARCHITECTURES移到project指令之前，单独作为全局变量设置
• 添加框架搜索路径，让CMake可以识别~/Library/Frameworks下的SFML框架，删除无效的/usr/local/include搜索路径

修正后的CMakeLists.txt #

cmake_minimum_required(VERSION 3.19)
set(CMAKE_OSX_ARCHITECTURES arm64 CACHE STRING "Build architecture for Apple Silicon" FORCE)

project(myProject)

set(CMAKE_CXX_STANDARD 17)
add_executable(myProject main.cpp)

# 添加自定义框架搜索路径
set(CMAKE_FRAMEWORK_PATH "${CMAKE_FRAMEWORK_PATH} ~/Library/Frameworks")

find_package(SFML 2.5 COMPONENTS system window graphics network audio REQUIRED)
target_include_directories(myProject PRIVATE ${SFML_INCLUDE_DIRS})
target_link_libraries(myProject sfml-system sfml-window sfml-graphics sfml-audio sfml-network)

生效验证 #

• 删除之前生成的build目录下所有缓存文件
• 重新执行cmake配置与编译命令，若仍然找不到SFML，可在cmake配置时添加参数-DSFML_ROOT=~/Library/Frameworks/SFML指定SFML根路径

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