开始使用开发者 CLI 工具 Zinnector®

Zinnector® 是 Zinn Digital® 针对 WordPress 开发者推出的免费、采用 MIT 许可证的命令行工具。它能够搭建站点，在您自己的机器上运行真实的 WordPress，而只需安装 Node（无需 Docker，无需 MAMP，且无需将 PHP 添加到 PATH 中）——随后会将您构建的内容与您即将部署到的托管节点进行比对并推送。本指南带您在约两分钟内从零开始运行一个站点，并在每一步指出成功时的表现，以便您了解何时出现了问题。

您需要准备什么

• Node 24 或更高版本。 运行 node --version；它必须打印出 v24 或更高版本。请从 nodejs.org 安装当前的 LTS 版本——在 Windows 上运行 winget install OpenJS.NodeJS.LTS，在 macOS 上运行 brew install node@24。
• npm，随 Node 一起提供。Zinnector® 会使用它一次，将 WordPress 运行时下载到其自己的缓存中。
• git，仅用于 zinnector push——部署由您的代码仓库驱动。
• Docker，仅当您通过 --runtime docker 显式请求时使用。默认运行时无需 Docker。

以下内容均不需要账户。只有在连接到托管节点时才需要 API 密钥，详情请参阅使用 Zinnector® 部署。

第 1 步 — 安装它

npm install -g zinnector

如果 npm 打印出 npm WARN EBADENGINE，说明您的 Node 版本低于该软件包声明的 >=24.18.1。安装仍会完成，但 CLI 将拒绝运行。请先升级 Node，然后再次安装。

第 2 步 — 检查版本

zinnector --version

成功： 显示版本号，例如 0.1.2。如果您看到 "Zinnector® needs Node 24 or newer — this is Node 20.x"，说明二进制文件已安装，但您的 Node 版本过低；该命令将以代码 78 退出，而不执行任何操作。

第 3 步 — 阅读帮助

zinnector --help

成功： 显示一个列出该流程五个命令（new、dev、link、check、push）的横幅，随后是每个命令及其单行用途。每个命令也支持其自身的 --help——zinnector dev --help 会列出运行时、PHP 和端口标志。完整列表及示例文档位于命令参考。

第 4 步 — 搭建站点

zinnector new my-site

成功： 显示 Created my-site 标题以及它写入的文件列表——zinnector.json、包含 plugins/、themes/ 和 mu-plugins/ 辅助程序的 wp-content 树、.gitignore 和一个 README——随后是接下来要运行的命令。其中没有任何占位符；项目开箱即用。--template plugin 或 --template theme 用于搭建在创建时即自动激活的插件或区块主题。

第 5 步 — 运行它

cd my-site
zinnector dev

首次运行时，Zinnector® 会在下载 WordPress 运行时之前询问一次——大小约为 570 MB，因为它包含了从 5.2 到 8.5 的每一个 PHP 构建版本——并将其放入其自己的缓存目录中，绝不会放入您的项目中。请回答 Y，或传入 --yes 以跳过此问题。在 Node 26 或更高版本上，它还会仅为运行时获取一个 Node 24（约 30 MB，已通过 nodejs.org 的校验和验证），因为运行时的原生模块仅针对 Node 24 和 25 预编译了二进制文件；您不需要编译器或 Visual Studio。

成功： 一个标识项目名称、PHP 版本和 WordPress 版本的代码块，随后是：

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

第 6 步 — 打开它

在浏览器中访问 http://127.0.0.1:9400。Success（成功）： 一个标题为 My WordPress Website 的全新 WordPress 站点，由您要求的 PHP 版本提供服务。http://127.0.0.1:9400/wp-admin 用于打开已登录的仪表盘。将插件放入 wp-content/plugins/ 或将主题放入 wp-content/themes/ 中，它就会在下次重新加载时出现——运行时会直接从您的项目中提供这些目录的服务。

按 Ctrl-C 停止。zinnector dev --once 会启动运行时，打印实际运行的内容（PHP 版本、WordPress 版本、加载的扩展）然后停止——当您想要验证而非空头承诺时非常有用。

接下来去哪里

• 使用 zinnector dev 进行本地开发 — 两种运行时、选择 PHP 和 WordPress 版本，以及从何处提供什么服务。
• 使用 Zinnector® 部署 — 登录、将项目链接到节点、预检、推送。
• 命令参考 — 每个命令、标志和示例。
• 故障排除 — 人们实际遇到的错误以及每个错误的修复方法。

相同的文档也位于 npm 和 GitHub 上的软件包 README 中，欢迎提交问题和拉取请求。