为 QDoc 安装 Clang

QDoc 在解析 C++ 文件以及 \fn 命令中的函数签名时使用 Clang。 Clang 是 LLVM 编译器基础设施项目 的一部分。如果要从源码构建 QDoc,必须安装 Clang 8.0 或更高版本。

你可以通过各种渠道获得 Clang:

  • Qt 在线安装程序中提供了 预构建的 Clang 包。这些包允许你静态链接 LLVM/Clang 库,但仅支持 Windows 上的 Release 构建。
  • Linux 发行版通常提供一个名为 libclang-devlibclang-devel 的软件包。Qt 的构建系统指示 CMake 查找 ClangConfig.cmake,如果要构建 QDoc,请确保安装提供此文件的软件包。运行 QDoc 只需要 libclang
  • 在 macOS 上,你还可以使用 Homebrew 的 llvm formula

注意:无法使用来自 http://releases.llvm.org/download.html 的预构建二进制文件,因为它们缺少 QDoc 所需的某些组件。

如果你将 Clang 安装在一个自定义的位置,你需要告诉 CMake 在哪里可以找到它。这可以通过在 CMAKE_PREFIX_PATH 缓存变量中添加安装路径来完成。