M1 Mac ZSH环境下Haskell配置LLVM及ghc编译报错排查

问题根因 #

Homebrew安装的带版本号的公式（如llvm@12）默认不会将自身二进制文件软链到系统全局路径，GHC运行时搜索不到LLVM工具链内的opt程序，就会抛出「无法识别LLVM版本」「找不到opt执行文件」的报错，本质是未完成安装提示要求的「将LLVM工具链暴露到PATH」配置。

具体操作步骤（ZSH环境） #

• 第一步：确认llvm@12的二进制目录，M1系列芯片Mac的Homebrew默认安装在/opt/homebrew路径下，llvm@12的可执行文件目录固定为/opt/homebrew/opt/llvm@12/bin
• 第二步：编辑ZSH配置文件，终端执行：

nano ~/.zshrc

• 第三步：在配置文件最末尾追加以下内容，把LLVM路径加入环境变量，顺便补上后续编译可能用到的头文件、链接库路径，避免其他关联报错：

export PATH="/opt/homebrew/opt/llvm@12/bin:$PATH"
export CPPFLAGS="-I/opt/homebrew/opt/llvm@12/include"
export LDFLAGS="-L/opt/homebrew/opt/llvm@12/lib"

• 第四步：保存退出编辑器：按快捷键Ctrl+O，按回车确认文件名，再按Ctrl+X退出nano
• 第五步：加载新配置让改动立即生效，执行：

source ~/.zshrc

有效性验证 #

配置完成后执行两个命令检查状态：

1. 执行which opt，正常返回路径应为/opt/homebrew/opt/llvm@12/bin/opt，说明Shell已经能识别LLVM工具
2. 执行opt --version，输出版本号为12.x系列，落在GHC要求的[9,13)版本区间内即符合要求

验证通过后再执行ghc --make <目标Haskell文件路径>即可正常编译，不会复现之前的错误。

避坑提示：不要用brew link llvm@12 --force做全局软链，很容易和其他版本的LLVM、系统内置工具产生冲突，单独在PATH里指定对应版本目录是最稳妥的方案。

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