macOS Monterey安装yesod-bin报错无法加载Cocoa框架如何解决

问题场景 #

参照Yesod官方快速入门教程操作，执行第3步安装命令stack install yesod-bin --install-ghc时编译失败，核心报错信息如下：

stack install yesod-bin --install-ghc                
Linking /Users/air/.stack/setup-exe-cache/x86_64-osx/tmp-Cabal-simple_mPHDZzAJ_3.0.1.0_ghc-8.8.4 ...
yesod-bin> configure
yesod-bin> Configuring yesod-bin-1.6.0.6...
yesod-bin> build
yesod-bin> Preprocessing executable 'yesod' for yesod-bin-1.6.0.6..
yesod-bin> Building executable 'yesod' for yesod-bin-1.6.0.6..
yesod-bin> [1 of 7] Compiling AddHandler
yesod-bin> [2 of 7] Compiling Devel
yesod-bin> <command line>: can't load framework: Cocoa (not found)

--  While building package yesod-bin-1.6.0.6 (scroll up to its section to see the error) using:
      /Users/air/.stack/setup-exe-cache/x86_64-osx/Cabal-simple_mPHDZzAJ_3.0.1.0_ghc-8.8.4 --builddir=.stack-work/dist/x86_64-osx/Cabal-3.0.1.0 build --ghc-options " -fdiagnostics-color=always"
    Process exited with code: ExitFailure 1

运行环境为macOS Monterey，仅安装Command Line Tools，未安装完整Xcode。

报错原因 #

macOS Monterey及更新版本中，仅安装Command Line Tools时，系统SDK内置的Cocoa等Framework不会被GHC链接器默认搜索到，不需要安装体积庞大的完整Xcode，通过指定Framework搜索路径即可解决问题。

解决步骤 #

• 1. 确认Command Line Tools安装路径，执行命令：
     xcode-select -p
     正常默认输出为/Library/Developer/CommandLineTools，如果输出其他路径，后续步骤里的路径替换成实际输出的路径即可。
• 2. 验证SDK路径存在，执行命令：
     ls /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks/Cocoa.framework
     如果输出路径信息说明路径正确；如果提示不存在，先执行ls /Library/Developer/CommandLineTools/SDKs/查看实际的SDK目录名，替换后续命令里的对应路径。
• 3. 清除之前失败的编译缓存：
     stack clean yesod-bin
• 4. 临时指定链接参数重新执行安装命令：
     stack install yesod-bin --install-ghc --ghc-options="-optl-F/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks"

如果希望永久生效不需要每次加参数，可以把以下配置追加到~/.cabal/config文件末尾：

package yesod-bin
  ghc-options: -optl-F/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks

之后直接执行原安装命令即可。

提示：如果后续安装其他Haskell包时也出现类似找不到系统Framework的报错，可以把上面配置里的包名改成对应包名，或者去掉package yesod-bin的行限制，让全局所有包编译时都带上这个搜索路径。

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