AI开发WordPress插件教程:零基础到上线全流程
20年程序员老站长 · 抖音号28176470161(阿明说)主理 · 2026 AI开发插件方法论
AI开发WordPress插件教程:2026年7月官方博客发布首个AI插件教程,最近两个大版本已内置AI Client等三大AI构建块。本页讲透五步流程:描述需求→AI生成→本地测试→打包上线,附Claude Code、DeepSeek、豆包提示词模板与安全审查要点,数据全部标注出处。
02 · AI开发插件时代到来
2026年7月30日,WordPress官方开发者博客发布《Build your first AI-Powered WordPress plugin》教程,作者Jonathan Bossenger用一个叫Photo to Post的插件演示全流程:输入图片URL,AI自动生成文字描述并创建带特色图片的草稿文章。developer.wordpress.org官方博客(2026年7月30日)
教程背后是实打实的基建:WordPress最近两个大版本已内置AI相关能力,包括Abilities API(标准方式注册功能单元)、WordPress AI Client(与厂商无关的PHP库)与MCP Adapter(把能力暴露给外部AI代理)三大构建块。developer.wordpress.org官方博客(2026年7月30日)
其中WordPress AI Client在7.0版本中随核心发布,插件通过PHP API即可直接调用AI模型,无需再分别对接各家厂商SDK;2026年5月官方博客还发布了《How to build an image generation plugin with the WordPress AI Client》,用内置客户端生成图片插件。developer.wordpress.org官方博客(2026年5月)
具体到开发体验:官方AI Client封装了提示词发送、模型选择与超时管理,插件开发者只需调用wp_ai_client_prompt()即可请求AI,官方教程还为图片生成场景增加了120秒超时过滤钩子,说明核心团队已把AI插件开发纳入正式支持范围。developer.wordpress.org官方博客(2026年5月)
生态侧同步转向:wordpress.com官方博客2026年2月12日发布《How to Build WordPress Plugins with AI: Claude Code + WordPress Studio Setup Guide》,定位直白——"从想法到可用插件只需几分钟,无需深度编码知识"(no deep coding knowledge required)。wordpress.com官方博客(2026年2月12日)
个人开发者同样入场:Nathan Onn发布教程《Build Your First WordPress Plugin with The Power of AI (Even if You Can't Code!)》,主张"即使不会编码也能用AI开发插件",并晒出28分钟完成一个插件的实测记录。nathanonn.com教程(2026年)
一组直观对比:传统路径学PHP加钩子系统需要数周,而2026年的AI路径从需求描述到跑通原型只需数小时;开发成本的量级变化,让"人人可做插件"第一次成为现实。
独特观点:AI开发插件的本质是把"需求表达"变成唯一瓶颈——提示词能力即开发能力,这是2026年WordPress开发者最值得投资的能力。工具在快速同质化,能准确描述"要什么、在哪里生效、边界是什么"的人,才能让AI产出可用代码。
再看具体版本:WordPress 6.9引入Abilities API,允许开发者注册可被REST、区块编辑器乃至外部AI代理调用的功能单元;Nathan Onn随即用它配合Claude Code构建了AI内链插件,并开源在GitHub供下载。nathanonn.com(2026年)themebazarbd等开发者社区也在2026年跟进发布AI插件开发指南,生态工具链已全面就绪。themebazarbd开发者指南(2026年)
03 · AI开发插件核心流程
AI开发WordPress插件可归纳为五步闭环:描述需求→AI生成代码→本地测试→打包上传→迭代优化。langvault.com的《How to Build WordPress Plugins with AI: The 2026 Developer's Guide》把同样的路径概括为"从零到发布(From Zero to Ship)"。langvault 2026开发者指南
2026年主流的AI工具包括:Claude Code(Anthropic出品的终端AI编码助手,wordpress.com官方教程主推)、Cursor(AI代码编辑器)、DeepSeek(国产大模型)与豆包(字节跳动大模型),四者均能生成可运行的PHP插件代码。wordpress.com官方博客(2026年2月12日)
- 描述需求:用自然语言说清插件功能、触发位置与预期效果,形成"一句话规格"。
- AI生成代码:把提示词发给AI,先出骨架,再逐模块补功能代码。
- 本地测试:在WordPress Studio或Local环境激活,验证前台、后台与停用状态。
- 打包上传:整理目录、补全readme.txt、压缩ZIP并上传安装验证。
- 迭代优化:根据线上反馈让AI增删功能,循环回到第一步。
迭代阶段的黄金法则:一次只改一个功能。langvault指南提醒,AI在连续对话中容易"遗忘"早期约束,每轮迭代都重申一遍插件名、版本、目录结构三要素,能显著降低回归错误。langvault 2026开发者指南
各步骤耗时参考:需求描述10-15分钟,AI生成骨架约1分钟,核心功能3-5轮对话,本地测试15-30分钟,打包上传5分钟。Nathan Onn实测整个流程28分钟完成一个WordPress插件。nathanonn.com(2026年)
工具选择有一个判断标准:Claude Code与Cursor侧重"代码优先",在终端或编辑器内直接读写插件文件,适合连续迭代;DeepSeek与豆包侧重"对话优先",支持中文语境的需求拆解与代码解释,适合零基础起步。实际项目中常组合使用:先用DeepSeek或豆包理清需求,再用Claude Code写码。langvault 2026开发者指南
04 · 环境准备:本地WordPress环境
第一块拼图是本地WordPress环境。WordPress Studio是wordpress.com官方推出的免费本地环境,支持Mac与Windows双平台,2026年2月12日官方教程即用它演示Claude Code开发插件,强调"本地运行、内容安全隔离在机器上"。wordpress.com官方博客(2026年2月12日)
备选方案是LocalWP:同为免费本地环境,内置站点管理、SSL证书与PHP版本切换,适合已有LocalWP使用习惯的开发者;两者选其一即可,流程完全通用。
WordPress Studio的安装只有三步:从wordpress.com官网下载安装包→按提示完成安装→新建站点(任意命名,如"My WordPress Website")。官方教程强调,因为Studio完全运行在本地,所有实验内容都安全隔离在你自己的机器上。wordpress.com官方博客(2026年2月12日)
两个环境的关键差异:WordPress Studio由官方团队维护,与Claude Code等AI工具配合最顺滑,官方教程主推;LocalWP则胜在多站点管理与一键共享(Live Link),适合需要向客户演示的开发场景。wordpress.com官方博客(2026年2月12日)
代码编辑器推荐VS Code,安装PHP Intelephense扩展后可获得语法高亮与错误提示,AI生成的代码如有语法问题会第一时间标红,配合Git管理版本更稳妥。
理解插件骨架结构能显著提升提示词质量。一个标准插件的目录长这样:
my-awesome-plugin/
├── my-awesome-plugin.php # 插件主文件(入口,含头部注释)
├── readme.txt # 插件说明(名称/描述/更新日志)
├── includes/
│ ├── class-main.php # 核心类文件
│ └── settings.php # 设置页面逻辑
├── assets/
│ ├── css/style.css # 样式
│ └── js/script.js # 脚本
└── uninstall.php # 卸载时清理数据
插件主文件是入口,readme.txt用于展示信息,includes/目录放类文件与功能模块,assets/目录放静态资源,uninstall.php负责"卸载干净"。developer.wordpress.org插件开发手册
05 · 第一步·用AI生成插件骨架
用AI生成骨架的关键,是给出一条结构完整的提示词。以"文章阅读时长估算"插件为例,可直接复制下面的模板:
生成一个WordPress插件,功能是根据文章字数估算阅读时长,
并在文章末尾输出"预计阅读 X 分钟"。
要求:
1. 包含插件主文件、readme.txt、无任何第三方依赖
2. 遵循WordPress Coding Standards
3. 用短代码 [reading_time] 输出结果
4. 先给出目录结构,再逐一生成文件内容
提示词三要素:明确功能(估算阅读时长)、明确交付物(主文件/readme)、明确约束(无依赖、遵循编码规范)。arestos博客把需求梳理总结为三步——先确定插件解决的核心问题(Identify the main purpose),再定义核心功能(Define core features),最后聚焦必做项(Focus on the must-haves)。arestos.com博客(2026年)
AI会先输出目录结构,再逐文件生成内容,其中主文件是WordPress识别插件的关键,头部必须包含标准注释信息:
<?php
/**
* Plugin Name: 阅读时长估算
* Description: 根据文章字数估算阅读时长并输出短代码
* Version: 1.0.0
* Author: 阿明说
* License: GPL-2.0-or-later
*/
if ( ! defined( 'ABSPATH' ) ) {
exit; // 禁止直接访问
}
提示词里加上"遵循WordPress编码规范(WordPress Coding Standards)",能显著减少缩进、命名与转义层面的返工量。developer.wordpress.org编码规范文档
进阶技巧:把"上下文"写进提示词。wordpress.com官方教程建议"Give Claude context about where you are in the file structure"——先告诉AI当前所在目录与项目结构,再提需求,生成的代码路径与引用关系会更准确,减少文件放错位置导致的加载失败。wordpress.com官方博客(2026年2月12日)
06 · 第二步·AI生成核心功能代码
骨架就绪后,把需求拆成AI能精确执行的功能描述。四个高频维度:钩子(Hook)、短代码(Shortcode)、设置页面(Settings Page)与数据库表(Database Table),在提示词里明确属于哪一类,AI的命中率会高很多。developer.wordpress.org插件开发手册
功能描述技巧一:明确触发时机。例如"在文章内容之后输出引用来源",对应过滤钩子the_content;"在后台菜单新增配置页",对应动作钩子admin_menu——把钩子名直接写进提示词。
技巧二:分段生成。一次让AI输出过长内容容易遗漏细节,建议把"注册短代码"与"短代码回调逻辑"分成两轮对话。langvault指南的建议是"一个功能一个提示词",复杂插件拆成5-10个小任务逐个击破。langvault 2026开发者指南
技巧三:给出输入输出示例。比如让AI生成短代码时,附上期望的调用方式与输出效果:
<?php
// 注册短代码:文章里写 [reading_time] 即输出
function hrl_reading_time_shortcode() {
$words = str_word_count( wp_strip_all_tags( get_post_field( 'post_content', get_the_ID() ) ) );
$minutes = max( 1, round( $words / 250 ) );
return '<p class="reading-time">预计阅读 ' . esc_html( $minutes ) . ' 分钟</p>';
}
add_shortcode( 'reading_time', 'hrl_reading_time_shortcode' );
技巧四:要求AI注释并解释关键行。wordpress.com官方教程明确建议:"Ask Claude to explain the generated code if something doesn't make sense"——看不懂就让AI解释,这是零基础者理解代码最有效的方式。wordpress.com官方博客(2026年2月12日)
涉及数据存储的插件,提示词要明确数据库表结构。例如"用$wpdb创建表hrl_read_stats,字段含post_id、words、minutes,并在插件卸载时删除该表"。明确表名、字段与生命周期后,AI会正确生成dbDelta建表代码与uninstall清理逻辑,避免"装了删不干净"。developer.wordpress.org数据库API文档
07 · 第三步·本地测试与调试
AI生成的代码必须在本地上线验证,测试环节按以下顺序执行:
- 在WordPress Studio或Local站点后台,进入"插件"页面找到新插件并激活。
- 确认激活无报错,访问站点前台触发对应功能(短代码/内容输出)。
- 在wp-config.php开启WP_DEBUG与WP_DEBUG_LOG,复现功能并查看debug.log日志。
- 把完整报错信息+出错页面地址粘贴给AI,要求"修复并解释原因"。
- 停用插件再复测,确认站点无残留报错后进入打包环节。
常见错误三类:语法错误(Parse error,多为引号或括号不匹配)、函数未定义(漏了包含文件或依赖)、钩子名拼写错误(挂载点无效)。修复方式统一——把报错原文原样粘贴给AI,附上"请修复并解释原因"。
把报错信息粘贴给AI的提示词模板:
我的插件在激活时报错,日志如下:
[2026-07-20 10:00:01] PHP Fatal error: Uncaught Error:
Call to undefined function hrl_calculate() in .../my-plugin.php:35
请帮我修复,并解释:
1. 报错原因是什么
2. 修复后的代码长什么样
3. 我下次如何避免同类问题
这种"报错原文+三个追问"的格式,能让AI定位问题并输出可复用的经验,实测修复成功率远高于直接问"怎么办"。
本地测试的价值在于零风险:WordPress Studio官方文档强调everything you build stays safely contained on your machine,AI生成的插件在本地环境随意折腾,都不会影响线上站点。wordpress.com官方博客(2026年2月12日)
建议至少覆盖三个场景:前台正常访问、后台正常操作、插件停用后站点无报错;涉及数据库的插件,还要测试激活、停用、再激活的重复流程。
调试的另一条捷径:让AI写单元测试。WordPress官方测试框架WP_UnitTests支持在本地运行PHPUnit,把AI生成的测试文件纳入后,每次修改代码都能自动回归,防止"修好一个错误又引入新错误"。
08 · 第四步·打包与上线准备
测试通过后进入打包阶段,操作步骤:
- 清理测试残留:删除debug.log、缓存目录与临时测试数据。
- 确认主文件头部注释完整(Plugin Name/Description/Version/Author/License)。
- 补全readme.txt,写清插件简介、安装方法与更新日志。
- 把插件目录压缩为ZIP,压缩包内第一层应为插件文件夹本身。
- 回到WordPress后台"插件→上传插件",安装ZIP验证可用后再分发。
主文件头部注释是WordPress识别插件的元数据来源,Version建议从1.0.0开始,License使用GPL-2.0-or-later(WordPress生态默认协议)。developer.wordpress.org插件开发手册
readme.txt采用"==="分隔的Markdown风格格式,内容如下:
=== 阅读时长估算 ===
Contributors: huolieniao
Tags: reading-time, reading, shortcode
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.0.0
License: GPL-2.0-or-later
== Description ==
根据文章字数估算阅读时长,通过短代码 [reading_time] 输出。
== Installation ==
1. 上传插件ZIP到后台并激活。
2. 在文章中插入短代码 [reading_time]。
== Changelog ==
= 1.0.0 =
* 首个版本
命令行打包更可控:在插件目录的上级执行 zip -r my-awesome-plugin.zip my-awesome-plugin,或右键压缩为ZIP;打包后先用 unzip -l 查看包内结构,确认第一层是插件文件夹而非散落文件,否则上传后WordPress会提示"插件目录不存在"。
readme.txt不只是文档:wordpress.org官方目录会解析其中"Description""Installation""Changelog"三个区块,用于生成插件页介绍与更新记录;活跃开发者习惯用"Tested up to"标注兼容的WordPress版本,7.0发布后该字段直接影响用户在后台看到的兼容性提示。wordpress.org插件目录规范(2026年7月)
若准备上架wordpress.org官方插件库,还需准备SVN仓库、插件页截图与开发者协议签署,完整审核要点见本专题站插件库上线页。developer.wordpress.org插件提交指南
09 · AI开发实战案例
案例一:wordpress.com官方"Hello Nick"演示。2026年2月12日官方教程的完整流程:安装Claude Code与WordPress Studio→在Studio的Terminal输入claude并信任文件夹→用一句话提示词"生成一个在后台打印Hello Nick的插件"→Claude生成完整插件文件→后台激活后顶部显示管理员通知。wordpress.com官方博客(2026年2月12日)
案例二:Nathan Onn的28分钟插件。他在LinkedIn分享经验"5 minutes of spec writing buys 28 minutes of AI freedom"——花5分钟写需求规格,换来28分钟AI自由开发;他还用WordPress 6.9的Abilities API配合Claude Code构建了AI内链插件。nathanonn.com(2026年)
案例三:langvault从零到发布。langvault的2026开发者指南覆盖需求文档、代码生成、readme撰写与打包发布全环节,并指出"AI非常擅长写文档"(AI is incredible at writing documentation),文档环节同样可以外包给AI。langvault 2026开发者指南
案例四:dev.to上的AI插件教程。开发者kalyna_pro在dev.to发布《How to Build a WordPress AI Plugin (Step-by-Step Guide 2026)》,展示如何用AI构建"调用大模型能力的AI插件",即把AI能力封装成可安装插件的过程。dev.to(2026年)
案例五:themebazarbd的AI开发指南。themebazarbd在2026年发布WordPress插件AI开发指南,覆盖提示词编写、骨架生成与钩子调试,其核心建议与本页一致:把大需求拆成小任务、每轮对话只解决一个问题。themebazarbd开发者指南(2026年)这也印证了AI插件开发正在成为社区主流方向。
案例共性:成功案例都把"需求描述"当作第一优先级——先写清楚要什么,再让AI写代码,这印证了本页的核心观点:提示词能力即开发能力。
10 · AI辅助开发注意事项
- 安全漏洞:AI可能生成SQL注入、XSS等不安全的代码,上线前必须逐行人工审查。
- 依赖缺失:AI可能引用未包含的第三方库或函数,导致线上白屏。
- 钩子误用:钩子挂错时机可能造成功能失效或性能拖慢。
上线前的五步安全审查清单,逐项打勾:
- SQL全部使用$wpdb->prepare预处理,无字符串拼接。
- 前端输出经esc_html或esc_attr转义,防XSS注入。
- 后台操作有current_user_can权限检查。
- 表单提交带nonce校验,防CSRF攻击。
- 依赖与第三方库完整包含,生产环境可离线运行。
这五条也是wordpress.org官方插件库人工审核的核心检查项,提前自检能显著提高过审率。developer.wordpress.org插件提交指南
官方立场同样强调验证:developer.wordpress.org的AI插件教程在展示能力的同时,为每个能力都设计了注册、权限校验与120秒超时配置,AI生成代码只是起点,验证是标配。developer.wordpress.org官方博客(2026年7月30日)
AI不了解你的服务器环境:PHP版本、内存限制、Nginx/Apache差异、缓存机制,AI都无法感知,生成代码必须在真实环境复测,不能只看本地通过。
测试环境先行:任何新代码先在WordPress Studio或Local跑通,再上生产;WordPress 7.0与6.9的AI构建块也在官方测试框架下有对应验证流程。developer.wordpress.org官方博客(2026年7月30日)
数据备份是最后防线:上线前用UpdraftPlus等备份插件完整备份数据库与文件,一旦AI生成代码导致故障可秒级回滚。
独特观点:AI生成的插件代码是"初稿"而非"成品"——发布到生产环境的每一行代码都必须经过人工安全审查,AI负责速度、人负责质量。把AI当成一个写初稿极快的实习生,而不是免检的正式员工。
真实世界的教训:2026年多起WordPress站点被黑事件均指向未审查的第三方插件代码;安全插件Wordfence的年度报告持续把"漏洞插件"列为第一攻击入口,AI开发加速了插件产出,也放大了审查责任。Wordfence年度安全研究报告(wordfence.com)
11 · 传统开发 vs AI开发
下表从四个维度对比传统手写与AI辅助两条开发路径(数据基于2026年主流实践):
| 对比维度 | 传统开发 | AI开发 |
|---|---|---|
| 时间成本 | 数天到数周(含学习成本) | 数分钟到数小时(Nathan Onn实测28分钟) |
| 技术门槛 | 需掌握PHP、钩子体系与WP架构 | 会描述需求即可起步,懂代码审查更佳 |
| 代码质量 | 可控、稳定、风格统一 | 初稿质量波动大,必须人工审查与重构 |
| 维护难度 | 自己写的代码,思路清晰 | 依赖AI注释与文档,需补齐说明才能长期维护 |
表格数据综合自wordpress.com官方教程、nathanonn实测与langvault指南(2026年)。
结论不是"二选一":AI不是替代程序员,而是放大效率。官方博客的定位是"AI Agent通过MCP Adapter与插件协作",人负责架构、审查与决策,AI负责批量生成与快速试错。developer.wordpress.org官方博客(2026年7月30日)
混合模式正在成为主流:官方目录中越来越多插件采用"AI生成初稿+人工重构核心逻辑"的开发流程,核心类文件仍由开发者掌控,重复性模板代码交给AI批量产出,兼顾速度与可控性。
12 · AI开发WordPress插件FAQ
Q1. ai开发wordpress插件怎么做?
五步流程:用自然语言描述需求→让AI(Claude Code/Cursor/DeepSeek/豆包)生成代码→在WordPress Studio本地激活测试→ZIP打包→上传上线。wordpress.com官方博客2026年2月12日教程显示,从想法到可用插件只需几分钟。wordpress.com官方博客(2026年2月12日)
Q2. 不会编程能用ai开发插件吗?
可以。Nathan Onn教程标题即"Even if You Can't Code",他实测28分钟完成一个插件;wordpress.com官方教程也强调无需深度编码知识。但建议先了解基础PHP语法与钩子概念,便于审查与调试。nathanonn.com教程(2026年)
Q3. ai开发插件安全吗?
取决于审查环节。AI生成代码可能存在SQL注入、XSS与依赖缺失风险;wordpress.org官方目录上架前有代码审查流程。自用插件务必本地测试、人工审查、备份后再上线,遵循"AI负责速度、人负责质量"。
Q4. ai生成代码要检查什么?
五个要点:SQL语句是否用prepare预处理、输出是否用esc_html/esc_attr转义、是否做权限检查(current_user_can)、表单是否有nonce校验、依赖库是否完整。可让AI按WordPress Coding Standards自查一遍。developer.wordpress.org编码规范
Q5. wordpress插件开发需要什么环境?
最低配置:本地WordPress环境(WordPress Studio或LocalWP)+VS Code+一款AI工具。WordPress Studio是wordpress.com官方免费本地环境,支持Mac与Windows,官方2026年2月12日教程即用它演示Claude Code开发流程。wordpress.com官方博客(2026年2月12日)
Q6. ai开发插件要多久?
简单插件约30分钟到1小时(Nathan Onn实测28分钟),中复杂插件半天到一天。时间主要花在需求描述、测试与调试上,写代码本身只占一小部分。nathanonn.com(2026年)
Q7. claude code怎么开发wordpress插件?
五步:安装Claude Code→安装WordPress Studio并创建站点→在Studio的Terminal窗口输入claude并确认信任文件夹→用一句话描述插件需求→激活并测试。wordpress.com官方教程的"Hello Nick"案例即走此流程。wordpress.com官方博客(2026年2月12日)
13 · 内链导读:继续深入AI开发
本页讲通用方法论,具体到工具实战,请继续阅读以下页面:
用DeepSeek写插件代码的提示词与调试技巧详见DeepSeek页;用豆包从零搭建插件的完整流程见豆包开发页;想把自己的插件发布到官方库,先看插件库上线页的审核要点。
14 · 结语
2026年的WordPress开发者生态已经给出明确信号:官方在7.0内置AI Client、在6.9引入Abilities API、在开发者博客发布AI插件教程,AI开发插件不是趋势,而是正在发生的事实。developer.wordpress.org官方博客(2026年7月30日)
记住本页两条主线:流程上,描述需求→AI生成→本地测试→打包上线五步闭环;质量上,AI生成的是初稿,人工安全审查是上线的必经关卡。
对零基础的站长,建议从wordpress.com官方"Hello Nick"案例起步,跑通Claude Code+WordPress Studio最小流程,再按本页提示词模板生成第一个正式插件。wordpress.com官方博客(2026年2月12日)
下一步行动:前往DeepSeek页领取专属提示词模板,或到豆包开发页体验中文大模型的完整开发流程,最终在插件库上线页把你的作品发布到wordpress.org官方库。
收藏本站,持续更新,祝你在独立站之路上少走弯路。
最后提醒一句心态:AI开发插件的学习曲线在"提问"而非"编程"。把每次报错、每个需求都当成一次提示词训练,坚持三个月,你会发现自己最熟练的技能不是敲代码,而是把模糊想法翻译成AI能执行的精确规格——这正是2026年开发者最核心的竞争力。
数据来源与更新说明
- developer.wordpress.org官方博客:《Build your first AI-Powered WordPress plugin》,Jonathan Bossenger,2026年7月30日
- developer.wordpress.org官方博客:《How to build an image generation plugin with the WordPress AI Client》,2026年5月
- wordpress.com官方博客:《How to Build WordPress Plugins with AI: Claude Code + WordPress Studio Setup Guide》,Margarita Loktionova,2026年2月12日
- arestos.com博客:《How to Build a WordPress Plugin With AI Claude Code》(2026年)
- nathanonn.com教程:《Build Your First WordPress Plugin with The Power of AI (Even if You Can't Code!)》(2026年)
- langvault.com:《How to Build WordPress Plugins with AI: The 2026 Developer's Guide (From Zero to Ship)》(2026年)
- dev.to:《How to Build a WordPress AI Plugin (Step-by-Step Guide 2026)》,kalyna_pro(2026年)
- developer.wordpress.org:插件开发手册、编码规范(WordPress Coding Standards)与插件提交指南
- themebazarbd:WordPress插件开发与AI工具应用指南(2026年)
- wordpress.org插件目录:插件元数据与readme.txt规范(2026年7月)