WordPress Playground 快速搭建临时测试环境 | 插件主题调试与蓝图分享

wp-playground by wordpress/agent-skills

421 周安装量

1,100 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/wordpress/agent-skills --skill wp-playground

开发测试 WordPress

🇨🇳中文介绍

WordPress Playground

使用场景

快速启动一个临时的 WordPress 环境，用于测试插件/主题，无需完整的本地开发环境。
在本地运行或迭代 Playground 蓝图（JSON）。
构建一个可复现的站点快照，用于分享或在 CI 中使用。
快速切换 WordPress/PHP 版本以复现问题。
在隔离的 Playground 环境中使用 Xdebug 调试插件/主题代码。

所需输入

宿主机环境要求：Node.js ≥ 20.18，npm/npx 可用。
要挂载的项目路径（使用 --auto-mount 或显式的挂载映射）。
期望的 WordPress 版本/PHP 版本（可选；默认为最新的 WordPress 和 PHP 8.3）。
如果要运行蓝图，需要提供蓝图文件的位置或 URL。
如果端口 9400 冲突，需要指定偏好的端口。
是否需要启用 Xdebug。

操作步骤

0) 注意事项

Playground 实例是临时的，基于 SQLite；切勿指向生产数据。
运行 CLI 前，请确认 Node ≥ 20.18 (node -v)。
如果要挂载本地代码，请确保其中不包含敏感信息；Playground 会将文件复制到内存文件系统中。

1) 快速本地启动（自动挂载）

cd <插件或主题根目录>
npx @wp-playground/cli@latest server --auto-mount

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

2) 手动挂载或多个挂载

当自动挂载不满足需求时（例如多插件、MU 插件、自定义内容），使用 --mount=/宿主机路径:/虚拟文件系统路径（可重复使用）。
如果需要引导安装流程，可以在安装前使用 --mount-before-install 进行挂载。
参考：references/cli-commands.md

3) 运行蓝图（无需启动服务器）

npx @wp-playground/cli@latest run-blueprint --blueprint=<文件或URL>

适用于脚本化设置或 CI 验证。支持远程 URL 和本地文件。
当本地蓝图需要引用捆绑的资源文件时，可添加 --blueprint-may-read-adjacent-files。
关于蓝图结构和常用标志，请参阅 references/blueprints.md。

4) 构建快照用于分享

npx @wp-playground/cli@latest build-snapshot --blueprint=<文件> --outfile=./site.zip

生成一个 ZIP 文件，可以在 Playground 中加载或附加到问题报告中。

5) 使用 Xdebug 调试

使用 --xdebug（或根据 CLI 版本使用 --enable-xdebug）启动，会显示一个 IDE 密钥，然后将 VS Code/PhpStorm 连接到 CLI 输出中显示的宿主机和端口。
结合 --auto-mount 用于插件/主题调试。
检查清单：references/debugging.md

使用 --wp= 指定 WordPress 版本（例如 6.9.0），使用 --php= 测试兼容性。
如果功能依赖于 Gutenberg 主干版本，建议优先使用最新的 WordPress 版本加上插件（如果可用）；Playground 镜像跟踪稳定的 WordPress 版本并捆绑了 Gutenberg。

7) 纯浏览器工作流（无需 CLI）

使用 URL 片段或查询参数快速启动预览：
- 片段：https://playground.wordpress.net/#<base64或json蓝图>
- 查询：https://playground.wordpress.net/?blueprint-url=<公开URL或zip>
使用在线蓝图编辑器 (playground.wordpress.net)，借助模式帮助编写蓝图；粘贴 JSON 并复制可分享的链接。

验证挂载的代码已生效（插件已列出/激活；主题已选中）。
对于蓝图/快照，使用 --verbosity=debug 重新运行以确认步骤已执行。
运行针对性的冒烟测试（例如，如果浏览器终端已暴露，则在 Playground shell 内运行 wp plugin list）或进行 UI 点击路径测试。

故障模式 / 调试

CLI 因 Node 版本问题退出：升级到 ≥ 20.18。
挂载未生效：检查路径，使用绝对路径，添加 --verbosity=debug。
蓝图无法读取本地资源文件：添加 --blueprint-may-read-adjacent-files。
端口已被占用：使用 --port=<空闲端口>。
UI 缓慢/卡顿：如果启用了 --experimental-multi-worker，请禁用它；或者启用它以提升 CPU 密集型任务的吞吐量。

如果需要 PHP 扩展或原生数据库访问，Playground 可能不适用；请回退到完整的 WordPress 环境或 wp-env/Docker。
关于纯浏览器嵌入或 VS Code 扩展的具体细节，请查阅上游文档：https://wordpress.github.io/wordpress-playground/

🇺🇸English

WordPress Playground

When to use

Spin up a disposable WordPress to test a plugin/theme without full stack setup.
Run or iterate on Playground Blueprints (JSON) locally.
Build a reproducible snapshot of a site for sharing or CI.
Switch WP/PHP versions quickly to reproduce issues.
Debug plugin/theme code with Xdebug in an isolated Playground.

Inputs required

Host machine readiness: Node.js ≥ 20.18, npm/npx available.
Project path to mount (--auto-mount or explicit mount mapping).
Desired WP version/PHP version (optional; defaults to latest WP, PHP 8.3).
Blueprint location/URL if running a blueprint.
Port preference if 9400 conflicts.
Whether Xdebug is needed.

Procedure

0) Guardrails

Playground instances are ephemeral and SQLite-backed; never point at production data.
Confirm Node ≥ 20.18 (node -v) before running CLI.
If mounting local code, ensure it is clean of secrets; Playground copies files into an in-memory FS.

1) Quick local spin-up (auto-mount)

cd <plugin-or-theme-root>
npx @wp-playground/cli@latest server --auto-mount

Opens on http://localhost:9400 by default. Auto-detects plugin/theme and installs it.
Add --wp=<version> / --php=<version> as needed.
For classic full installs already present, add --skip-wordpress-setup and mount the whole tree.

2) Manual mounts or multiple mounts

Use --mount=/host/path:/vfs/path (repeatable) when auto-mount is insufficient (multi-plugin, mu-plugins, custom content).
Mount before install with --mount-before-install for bootstrapping installer flows.
Reference: references/cli-commands.md

3) Run a Blueprint (no server needed)

npx @wp-playground/cli@latest run-blueprint --blueprint=<file-or-url>

Use for scripted setup/CI validation. Supports remote URLs and local files.
Allow bundled assets in local blueprints with --blueprint-may-read-adjacent-files when required.
See references/blueprints.md for structure and common flags.

4) Build a snapshot for sharing

npx @wp-playground/cli@latest build-snapshot --blueprint=<file> --outfile=./site.zip

Produces a ZIP you can load in Playground or attach to bug reports.

5) Debugging with Xdebug

Start with --xdebug (or --enable-xdebug depending on CLI release) to expose an IDE key, then connect VS Code/PhpStorm to the host/port shown in CLI output.
Combine with --auto-mount for plugin/theme debugging.
Checklist: references/debugging.md

6) Version switching

Use --wp= to pin WP (e.g., 6.9.0) and --php= to test compatibility.
If feature depends on Gutenberg trunk, prefer the latest WP release plus plugin if available; Playground images track stable WP plus bundled Gutenberg.

7) Browser-only workflows (no CLI)

Launch quick previews with URL fragments or query params:
- Fragment: https://playground.wordpress.net/#<base64-or-json-blueprint>
- Query: https://playground.wordpress.net/?blueprint-url=<public-url-or-zip>
Use the live Blueprint Editor (playground.wordpress.net) to author blueprints with schema help; paste JSON and copy a shareable link.

Verification

Verify mounted code is active (plugin listed/active; theme selected).
For blueprints/snapshots, re-run with --verbosity=debug to confirm steps executed.
Run targeted smoke (e.g., wp plugin list inside Playground shell via browser terminal if exposed) or UI click-path.

Failure modes / debugging

CLI exits complaining about Node : upgrade to ≥ 20.18.
Mount not applied : check path, use absolute path, add --verbosity=debug.
Blueprint cannot read local assets : add --blueprint-may-read-adjacent-files.
Port already used : --port=<free-port>.
Slow/locked UI : disable --experimental-multi-worker if enabled; or enable it to improve throughput on CPU-bound runs.

Escalation

If PHP extensions or native DB access are required, Playground may be unsuitable; fall back to full WP stack or wp-env/Docker.
For browser-only embedding or VS Code extension specifics, consult the upstream docs: https://wordpress.github.io/wordpress-playground/

Weekly Installs

363

Repository

wordpress/agent-skills

GitHub Stars

985

First Seen

Feb 1, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex271

opencode263

gemini-cli260

github-copilot256

cursor253

kimi-cli246

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

106,200 周安装

WordPress Playground 快速搭建临时测试环境 | 插件主题调试与蓝图分享

🇨🇳中文介绍

WordPress Playground

使用场景

所需输入

操作步骤

0) 注意事项

1) 快速本地启动（自动挂载）

相关 Skills

2) 手动挂载或多个挂载

3) 运行蓝图（无需启动服务器）

4) 构建快照用于分享

5) 使用 Xdebug 调试

6) 版本切换

7) 纯浏览器工作流（无需 CLI）

验证

故障模式 / 调试

升级方案

🇺🇸English

WordPress Playground

When to use

Inputs required

Procedure

0) Guardrails

1) Quick local spin-up (auto-mount)

2) Manual mounts or multiple mounts

3) Run a Blueprint (no server needed)

4) Build a snapshot for sharing

5) Debugging with Xdebug

6) Version switching

7) Browser-only workflows (no CLI)

Verification

Failure modes / debugging

Escalation

最新 Skills