macOS要求

在本页面上，您将学到：

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

Node.js

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

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

$ node --version

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

v16.20.2

如果命令失败并显示错误，这意味着您尚未安装Node.js。安装Node.js的最佳方法是使用nvm（Node Version Manager）。跳转至安装nvm和Node.js 查找说明。

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

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

$ nvm alias default 16

现在您已经准备好安装Antora。

我们建议使用 Node Version Manager（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

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