Mac下用asdf安装Erlang遇‘fop is missing’错误的解决咨询

我之前也碰到过这个问题，其实这个警告本质上是Erlang编译过程中找不到FOP（Formatting Objects Processor）工具来生成官方PDF文档，所以用fakefop生成占位文件凑数。它不会影响Erlang的正常运行，但如果看着不舒服或者需要完整的Erlang文档，这里有两种解决办法：

方法1：安装FOP工具（推荐，解决根源问题） #

Mac上可以通过Homebrew快速安装FOP：

1. 先更新Homebrew的包索引，确保能拿到最新的软件包信息：

   brew update
   

2. 安装FOP：

   brew install fop
   

3. 安装完成后，重新用asdf安装Erlang（替换<version>为你需要的版本，比如26.0.2）：

   asdf install erlang <version>
   

这样编译过程就能找到FOP，正常生成完整的PDF文档，警告也会消失。

方法2：跳过文档生成（快速消除警告） #

如果不需要Erlang的官方PDF文档，完全可以直接跳过文档生成步骤，从根源上避免这个警告：

1. 设置环境变量告诉Erlang编译脚本不要生成文档：

   export ERLANG_BUILD_DOCS=no
   

2. 接着执行asdf的安装命令即可：

   asdf install erlang <version>
   

补充说明 #

如果你之前已经安装了Erlang但想修复这个问题，先卸载已安装的版本：

asdf uninstall erlang <version>

然后根据上面的方法重新安装就行。

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