知识库

开始使用 Zinnector®，开发者命令行界面

在 Node 24 或更高版本上安装免费的 Zinnector® CLI，然后在两分钟内验证其正常运行：--version、--help、搭建网站骨架、在无需 Docker 的情况下于本地运行真实的 WordPress，并在您的浏览器中将其打开 — 同时展示每一步成功时的效果。

Zinnector® 是 Zinn Digital® 专为 WordPress 开发者打造的免费且基于 MIT 许可的命令行工具。它能够脚手架化生成站点，除了 Node 之外无需安装任何其他软件——无需 Docker，无需 MAMP，PATH 中也无需配置 PHP——即可在您自己的机器上运行真实的 WordPress，随后对照您即将部署到的主机槽位检查您构建的内容并进行推送。本指南将在大约两分钟内带您从零开始运行一个站点，并说明每个步骤成功时的状态，以便您在出现异常时能够及时知晓。

您需要准备的内容

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 明确要求时才需要。默认运行时完全不需要。

以下所有操作均无需账户。只有当您准备使用主机槽位时，才需要 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。成功标志： 呈现一个全新的 WordPress 站点，标题为 My WordPress Website，由您所请求的 PHP 版本提供服务。http://127.0.0.1:9400/wp-admin 会直接打开已登录的管理控制面板。将插件放入 wp-content/plugins/ 或将主题放入 wp-content/themes/，下次刷新页面即可生效——运行时直接从您的项目中提供这些目录的内容。

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