在为区块编辑器开发时,您需要 Node.js 开发工具以及代码编辑器和本地 WordPress 环境(请参阅 区块开发环境)。Node.js (node) 是一个开源运行时环境,允许您从终端(也称为命令行界面,CLI,或 shell)执行 JavaScript 代码。
安装 node 将自动包含 Node 包管理器 (npm) 和 Node 包执行 (npx),这两个工具在区块和插件开发中经常使用。
Node 包管理器 (npm) 具有多种用途,包括依赖管理和脚本执行。它是推荐的包管理器,并在所有文档中广泛介绍。
Node 包执行 (npx) 工具用于在不全局安装的情况下运行来自包的命令,通常在使用 create-block 包创建区块脚手架时使用。
Mac 和 Linux 上的 Node.js 安装(使用 nvm)
建议使用 Node 版本管理器 (nvm) 来安装 Node.js。这允许您安装和管理特定版本的 node,这些版本安装在您的主目录中,避免任何全局权限问题。
以下是使用 nvm 安装 node 并设置区块开发推荐 Node.js 版本的快速说明。有关更多详细信息,请参阅 完整安装指南。
- 打开终端并运行以下内容以安装
nvm。在 macOS 上,所需的开发工具默认未安装。如果提示请安装它们。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
- 退出并重新启动终端。
- 在终端中运行
nvm install --lts以安装最新的 LTS(长期支持)版本的 Node.js。 - 在终端中运行
node -v和npm -v以验证安装的node和npm版本。
如果需要,您还可以安装特定版本的 node。例如,通过运行 nvm install 18 安装版本 18,并通过运行 nvm use [version-number] 在不同版本之间切换。有关更多详细信息,请参阅 nvm 使用指南。
某些项目(如 Gutenberg)包含一个 .nvmrc 文件,该文件指定应使用的 node 版本。在这种情况下,运行 nvm use 将自动选择正确的版本。如果版本尚未安装,您将收到错误消息,告诉您需要添加哪个版本。运行 nvm install [version-number] 然后运行 nvm use。
Windows 和其他系统上的 Node.js 安装
您可以直接从主要的 Node.js 网站 下载 Node.js 安装程序。推荐使用最新版本。安装程序适用于 Windows 和 Mac,二进制文件适用于 Linux。
Microsoft 还提供了一份 详细指南,介绍如何在 Windows 和 WSL 上安装 nvm 和 Node.js。
故障排除
如果您在安装 node 时遇到错误 zsh: command not found: nvm,您可能需要创建默认配置文件。
macOS 上的默认 shell 是 zsh,因此通过在终端中运行 touch ~/.zshrc 来创建配置文件。如果文件已存在,运行它也没问题。Ubuntu(包括 WSL)的默认配置文件是 bash,因此请使用 touch ~/.bashrc。然后重复步骤 2-4。
最新的 node 版本应适用于大多数开发项目,但请注意某些包和工具有特定要求。如果遇到问题,您可能需要安装并使用之前的 node 版本。此外,请确保检查项目是否有 .nvmrc 并使用指示的 node 版本。
其他资源
- Node.js(官方文档)
- Node 版本管理器(官方文档)
- 为本地 WordPress 开发安装 Node.js 和 npm(Learn WordPress 教程)