WordPress Agent Skills 本地开发实战wp-envDocker与 WordPress Playground 选型对比【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills做 WordPress 插件或主题开发第一步就是搭一个本地开发环境。这篇文章带你用 WordPress Agent Skills 项目里的两份核心技能快速掌握wp-envDocker 方案与WordPress PlaygroundWASM 方案的使用差异并给出一套新手也能直接套用的选型方法帮你少踩坑、少走弯路。1️⃣ 为什么本地环境选错会浪费一整天新手最常见的两个痛点装了一堆东西还是跑不起来Docker 没启动、端口被占用、数据库损坏……反复折腾环境太重不敢动本地 WordPress 越堆越乱想重来又舍不得结果改代码改到最后发现环境问题。Agent Skills 项目为 AI 编程助手内置了「WordPress 专家知识」其中 skills/wp-env/SKILL.md 和 skills/wp-playground/SKILL.md 分别覆盖了两种本地方案的标准操作。即使你不使用 AI 助手照着技能文档的步骤走也是最省时间的路径。2️⃣ 两种方案 30 秒速览对比维度wp-envDockerWordPress Playground运行方式Docker 容器浏览器 / Node.js 中的 WebAssembly前置依赖Docker Node.js 18.12仅 Node.js 20.18CLI 模式数据库真实 MySQLSQLite内存启动速度较慢拉镜像、起容器秒级开箱即用数据持久化可reset数据可跨重启保留一次性环境用完即弃start可本地持久化适合场景跑 PHPUnit、调试 Xdebug、长期开发快速验证、演示分享、兼容性测试配置文件.wp-env.jsonBlueprint JSON可选 官方技能给出的默认建议想快速开一个本地 WordPress优先用 Playground只有在真正需要 Docker 能力时才上 wp-env见第 5 节决策清单。3️⃣ wp-envDocker标准本地开发工作流3.1 一键安装与启动全局安装后启动即可wp-env 会自动扫描当前目录识别出插件Plugin Name头、主题style.css或 WordPress 核心代码并自动挂载npm -g install wordpress/env wp-env start启动成功后默认登录入口是http://localhost:8888/wp-admin/账号admin密码password。验证环境是否就绪只需两条命令wp-env status # 查看容器与端口状态 wp-env run cli wp plugin list # 确认插件已被挂载3.2 日常高频命令清单命令用途wp-env stop停止环境、释放端口wp-env reset development重置开发数据库白屏救星wp-env logs实时查看 PHP / Docker 日志wp-env start --auto-port端口被占用时自动换端口wp-env start --xdebug开启 Xdebug 断点调试wp-env run cli 命令在容器内执行 WP-CLI / Composer / PHPUnit3.3 新手三大坑与解法技能文档内置了完整的故障对照表skills/wp-env/SKILL.md最常见的三个Cannot connect to Docker daemon→ Docker 没启动打开 Docker Desktop 即可Port 8888 already in use→ 用--auto-port或在.wp-env.json里自定义端口参考评测案例 eval/scenarios/wp-env-troubleshoot-port.json插件不显示 / 白屏→ 检查插件头部注释是否规范或执行wp-env reset all wp-env start。完整的「搭好环境 → 挂载插件 → 跑测试」流程可参考 eval/scenarios/wp-env-start-plugin.json。4️⃣ WordPress Playground零 Docker 的轻量方案Playground 用 WebAssembly 在本地或浏览器里跑完整 WordPress配合 SQLite不需要装 Docker是新手验证想法的最低成本选项。4.1 一条命令启动本地站点进入插件或主题根目录执行npx wp-playground/clilatest startCLI 会自动完成识别项目类型 → 挂载本地代码 → 打开浏览器 → 管理员自动登录且站点状态在会话间保持想重建用start --reset。需要手动控制时可用server命令例如server --auto-mount自动挂载当前目录--mount本地路径:容器内路径精确挂载多个插件细节见 skills/wp-playground/references/cli.md。4.2 版本切换与快照兼容性测试利器# 指定 WordPress / PHP 版本复现线上兼容性问题 npx wp-playground/clilatest server --wp6.7 --php8.1 # 把当前站点打包成可分享的快照 npx wp-playground/clilatest build-snapshot --outfile./site.zipbuild-snapshot生成的 ZIP 可以直接发给同事复现你的问题比「在我机器上是好的」高效得多。4.3 浏览器里直接分享一个「活的」WordPress不想让对方装任何东西Playground 支持 URL 分享例如带上参数即可让访客直接看到装了特定插件、指定版本 PHP 的站点https://playground.wordpress.net/?php8.4wplatestplugingutenbergurl/wp-admin/复杂的多步骤环境装主题、导入内容、执行 PHP则用Blueprint JSON声明式描述完整语法见 skills/blueprint/SKILL.mdURL 参数详解见 skills/wp-playground/references/website.md。⚠️ Playground 实例是一次性的 SQLite 环境请勿指向任何生产数据需要真实数据库或持久化时请回到 wp-env。5️⃣ 选型决策清单到底该用哪个技能文档给出了明确的「wp-env or wp-playground」判断标准skills/wp-env/SKILL.md按顺序自查判断条件选择只是快速看看效果 / 做个演示 / 分享可运行的站点✅ WordPress Playground仓库里已有.wp-env.json配置文件✅ wp-env要跑 PHPUnit 等依赖真实 MySQL的测试✅ wp-env需要在环境里执行任意命令shell、Composer、完整 WP-CLI✅ wp-env在开发 WordPress 核心或 Gutenberg 仓库✅ wp-env明确想用 Docker / 需要与 CI 的容器流程一致✅ wp-env其他一切情况✅ WordPress Playground默认一个有趣的折中wp-env 也支持实验性的 Playground 运行时npx wordpress/env start --runtimeplayground让已有.wp-env.json的项目在免 Docker 时回退运行——但此时 MySQL 换成 SQLite、wp-env run也不可用所以它只是「兜底」不是第三种选择。6️⃣ 让 AI 编程助手替你决策Agent Skills 的正确打开方式以上所有流程都沉淀在 WordPress Agent Skills 仓库里AI 助手安装后会按 skills/wordpress-router/references/decision-tree.md 的路由逻辑自动选路提到「PHPUnit、Docker、wp-env」→ 走wp-env技能提到「wp-playground/cli、Blueprint、分享链接」→ 走wp-playground技能需要写 Blueprint JSON → 交给blueprint技能。安装方式以 Claude Code 全局安装为例git clone https://gitcode.com/gh_mirrors/agents/agent-skills cd agent-skills npm -g install wordpress/env # 按需安装本地环境工具更多技能区块开发、主题开发、插件开发、REST API 等 18 个一览见 README.md技能编写规范见 docs/authoring-guide.md。遇到 Playground 调试问题断点不命中、启动卡住还有专门的排障参考 skills/wp-playground/references/debugging.md。7️⃣ 总结一张图记住选型口诀默认选 Playground快、轻、可分享90% 的尝鲜场景够用三种情况上 wp-env要真数据库PHPUnit、要任意命令执行、仓库已用.wp-env.json两者都是「用完可弃」的本地环境别在里面堆生产数据定期reset保持环境干净。选对本地环境你的 WordPress 开发效率从第一天起就赢在起跑线 【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考