迁移至Apple Silicon Mac的架构不匹配库问题及解决咨询

潜在问题肯定会有，主要集中在这几点： #

• 编译/链接报错：构建工具（比如CMake）可能优先扫描/usr/local/lib，误把Intel架构的库当成依赖，就会出现你之前碰到的“架构不匹配”，甚至编译出的程序运行时直接弹bad CPU type in executable，或者被迫用Rosetta 2转译，拖慢性能。
• 版本依赖混乱：同一个库可能在/opt/homebrew（arm64原生）和/usr/local（旧Intel/双架构）各存一个版本，运行时可能错误加载旧版本，引发莫名其妙的兼容性bug。
• 磁盘空间浪费：纯Intel库和重复的双架构库占着硬盘空间，完全没用。

彻底清理与修复步骤 #

1. 先排查/usr/local里的旧库 #

用file命令检查单个库的架构：

file /usr/local/lib/libSDL2.dylib

输出里如果只有x86_64就是纯Intel库，同时有arm64和x86_64是双架构库。

批量扫描所有动态库：

for lib in /usr/local/lib/*.dylib; do
    echo "$lib: $(file "$lib" | grep -oE '(x86_64|arm64)+')"
done

2. 先备份，再动手 #

别直接删，先把/usr/local整个打包备份，防止误删有用的工具：

sudo tar -czf ~/usr_local_backup.tar.gz /usr/local

3. 针对性清理 #

• 纯Intel架构库：直接删，这些库对原生arm64程序完全没用，只会添乱。可以手动筛选后删除，或者用命令批量删（注意确认路径）：

  sudo rm -rf $(find /usr/local/lib -type f -name "*.dylib" -exec file {} \; | grep -v arm64 | awk -F: '{print $1}')
  

• 双架构库：如果/opt/homebrew里已经有对应的arm64原生版本，也可以删掉/usr/local里的，留着只会占空间。
• 注意：别直接删/usr/local整个目录！有些手动安装的工具可能不在Homebrew里，先检查/usr/local/bin里的程序架构，确认是Intel的再删对应的库。

4. 固定路径优先级，避免再踩坑 #

把Homebrew的路径放到/usr/local前面，确保构建工具优先用arm64原生库：
在_{/.zshrc（或}/.bashrc）里添加：

export PATH="/opt/homebrew/bin:$PATH"
export LD_LIBRARY_PATH="/opt/homebrew/lib:$LD_LIBRARY_PATH"
export DYLD_LIBRARY_PATH="/opt/homebrew/lib:$DYLD_LIBRARY_PATH"

然后生效配置：

source ~/.zshrc

CMake项目里也可以明确指定Homebrew路径，避免误找旧库：

set(CMAKE_PREFIX_PATH "/opt/homebrew")
find_package(SDL2 REQUIRED)

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