
WordPress 的官方资料分散在多个站点,新手常常不知道从哪里看起,搜到的中文转载又可能已经过时。这份导读按角色整理官方资料的入口和推荐阅读顺序,帮助你优先读最有用的部分。
核心成果
- HOWTO步骤数:13步(改造对照基线 / 可迁移验收口径)
- 引用官方文档数:4篇(改造对照基线 / 可迁移验收口径)
- 失败模式条目:14个(改造对照基线 / 可迁移验收口径)
- 清单可勾选项:21项(改造对照基线 / 可迁移验收口径)
- 清单可勾选项:18项(改造对照基线 / 可迁移验收口径)
- 失败模式条目:5个(改造对照基线 / 可迁移验收口径)
一、官方资料的主要入口
- WordPress.org 文档wordpress.org/documentation,面向站长和使用者,涵盖安装、设置与编辑器使用。
- 开发者资源developer.wordpress.org,包括主题手册、插件手册、区块编辑器手册、REST API 手册与代码参考。
- Make WordPressmake.wordpress.org,各贡献团队的博客,发布版本说明、开发说明(Dev Notes)与路线图。
- Learn WordPresslearn.wordpress.org,官方免费课程、视频教程与在线研讨。
二、按角色推荐阅读
站长与运营
- 区块编辑器使用文档:区块、模式与可复用内容;
- 站点健康与更新管理;
- 官方安全加固指南(Hardening WordPress),配合安全加固清单阅读。
主题开发者
- Theme Handbook:模板层级、模板标签、主题功能;
- Global Settings & Styles(theme.json)章节;
- 主题审核要求,即使不上架也可作为质量标准。
可结合主题开发入门路径按阶段阅读。
插件开发者
- Plugin Handbook:钩子、安全(数据校验、转义、nonce)与国际化;
- Code Reference:查询函数、类与钩子的源码与用法;
- 插件目录指南与安全最佳实践。
区块开发者
- Block Editor Handbook:快速入门与 block.json;
- Interactivity API 文档;
- Gutenberg 项目的版本更新说明,关注每个版本的新特性。
运维与 DevOps
- WP-CLI 手册与命令参考;
- 服务器环境要求(PHP、MySQL/MariaDB 推荐版本);
- 高级管理文档中的性能与缓存章节。
三、高效阅读的建议
- 以英文原版为准,中文资料注意核对发布日期与适用版本;
- 每个大版本发布前阅读 Make Core 博客的 Field Guide,提前评估兼容风险;
- 遇到具体函数先查 Code Reference,再看用户贡献的示例。
实际项目中的常见问题,可以先查常见报错速查。
