M3芯片MacOS下Brew安装的libpng架构不兼容问题求助

问题根源 #

核心问题是从x86架构旧Mac迁移配置后，Homebrew仍运行在Rosetta模拟环境中，导致安装的libpng为x86_64架构，与M3芯片需要的arm64架构不兼容。链接器因此忽略不兼容的库文件，最终出现符号未找到的错误。

解决方案步骤 #

1. 检查当前Homebrew架构
   运行命令确认Homebrew的运行环境：

   brew config
   

   查看输出的CPU字段，若显示x86_64，说明当前是Rosetta下的x86版本Brew，需替换为原生arm64版本。

2. 卸载旧的x86版本Homebrew
   先卸载所有x86 Brew安装的包，再删除Brew目录：

   /usr/local/bin/brew uninstall --force $(brew list)
   sudo rm -rf /usr/local/Homebrew
   sudo rm -rf /usr/local/bin/brew
   

3. 安装原生arm64版本Homebrew
   执行官方安装脚本，arm64版本Brew默认安装到/opt/homebrew目录：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

   安装完成后，确保将/opt/homebrew/bin加入系统PATH（安装脚本通常自动配置，若未生效可手动在~/.zshrc或~/.bashrc中添加：export PATH="/opt/homebrew/bin:$PATH"）。

4. 重新安装libpng
   用新的arm64 Brew安装libpng，此时安装的库为arm64架构：

   brew install libpng
   

5. 验证库架构并重新编译
   先确认libpng的架构为arm64：

   file $(brew --prefix libpng)/lib/libpng16.dylib
   

   输出应包含arm64字样。之后用正确参数编译项目：

   gcc -o render_region render_region.c $(libpng-config --cflags --ldflags)
   

   此时libpng-config会自动获取arm64版本库的路径，无需手动指定。

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