macOS 要求

在本页中，您将了解到：

由于 Antora 是基于 Node.js 构建的，因此安装和运行 Antora 需要在计算机上安装 Node.js（命令：node、npm 和 npx）。

Node.js

您可以在 Antora 中使用任何 Node.js 的活动 LTS 或维护 LTS 版本，但我们建议您使用最新的活动 LTS 版本，以便从最新的性能和安全增强功能中获益。 Node.js 发布时间表显示了当前的 Node.js LTS 版本。

要查看是否已安装 Node.js，以及安装的版本，请打开终端并键入

$ node --version

您应该看到一个版本字符串，例如：

v16.20.0

如果 命令失败并显示错误，这意味着您没有安装 Node.js。安装 Node.js 的最佳方法是使用 nvm（Node 版本管理器）。跳转到安装 nvm 和 Node.js 和 Node.js 查看说明。

如果 命令返回的版本不是当前的 LTS 版本，请使用 nvm（或软件包管理器）升级到最新的 Node.js LTS 版本。

如果 命令返回的版本是当前的 Node.js LTS 版本，请在终端中键入以下命令，确保将该版本设置为默认版本：

$ nvm alias default 16

现在您可以安装 Antora 了。

我们建议使用 Node 版本管理器 (nvm) 来管理 Node.js 安装，但这并非必要条件。请按照 nvm 安装指南在您的计算机上安装 nvm。成功安装 nvm 后，关闭当前终端，打开一个新终端，然后返回此处。

如果运行安装脚本后出现 nvm: command not found（找不到命令），则说明安装脚本未成功完成。请务必按照安装脚本发出的所有提示进行操作。如果遇到问题，请查阅安装指南中的故障排除部分。

许多 CI 环境使用 nvm 来管理构建作业中使用的 Node.js 版本。通过使用 nvm，您可以使自己的设置与用于生成和发布生产网站的环境保持一致。

安装 nvm 后，打开一个新终端，安装当前的 Node.js LTS 版本。

$ nvm install --lts

上述命令将安装当前的 Node.js LTS 版本，并自动将其设置为默认别名。

Node.js 安装完成后，就可以安装 Antora 了。

如果已安装 nvm，但未安装最新的 LTS 版本，请在终端中键入以下命令：

$ nvm install --lts

要将最新版本的 Node.js 设置为任何新终端的默认设置，请键入：

$ nvm alias default 16

现在您已经安装了最新的 Node.js LTS 版本，可以安装 Antora 了。