
WordPress 主题开发的门槛不高,但要写出可维护、性能好、方便运营的主题,需要系统掌握几块核心知识。下面的路径按由浅入深排列,每个阶段配一个练习项目,适合有前端或 PHP 基础的开发者。
核心成果
- 模板部件复用数:15个(改造对照基线 / 可迁移验收口径)
- 编辑器内验收项:8项(改造对照基线 / 可迁移验收口径)
- theme.json token覆盖:91%(改造对照基线 / 可迁移验收口径)
- 样式回归缺陷关闭数:17个(改造对照基线 / 可迁移验收口径)
- theme.json token覆盖:45%(改造对照基线 / 可迁移验收口径)
阶段一:环境与基础(约 1 周)
- 本地环境:Local、Docker 或宝塔面板搭建 LNMP;
- 了解目录结构:wp-content、themes、plugins、uploads;
- 掌握 WP-CLI 常用命令:安装、导入导出、搜索替换。
练习:搭建本地站点,导入官方 Theme Unit Test 测试数据。
阶段二:模板层级与主循环(约 1–2 周)
- 模板层级(Template Hierarchy):WordPress 如何决定用哪个模板渲染页面;
- 主循环(The Loop)与
WP_Query自定义查询; - 模板标签:the_title、the_content、the_permalink 等;
- 使用
get_template_part拆分模板部件。
练习:从零写一个经典博客主题,包含首页、文章、页面、归档、搜索与 404 模板。
阶段三:钩子与功能扩展(约 2 周)
- 动作(Action)与过滤器(Filter)的区别与优先级;
- 注册菜单、侧栏与主题支持(title-tag、post-thumbnails);
- 正确加载脚本样式:wp_enqueue 系列函数;
- 安全输出:转义(esc_html、esc_attr、esc_url)、nonce 与权限检查。
阶段四:内容建模(约 2 周)
- 自定义文章类型(CPT)与自定义分类法;
- 自定义字段:原生 Meta 与 ACF 等字段插件;
- REST API 基础。
练习:为企业站建立“产品”和“案例”两个内容类型,带筛选与详情模板。本站的主题、插件、方案、资源、案例栏目就是类似结构。
阶段五:区块编辑器与区块主题(约 2–3 周)
- 用 theme.json 配置全局样式与编辑器能力;
- 区块模式(Patterns)、样式变体与模板部件;
- 使用 @wordpress/scripts 开发自定义区块。
概念理解可先读区块主题(FSE)入门与选型。
阶段六:工程化与质量
- 代码规范PHPCS + WordPress Coding Standards。
- 性能自测按性能测评方法检查核心模板。
- 二次开发遵循子主题与二次开发规范。
- 官方资料见WordPress 官方文档精选导读。
