WordPress REST API v1/v2/v3差异对比及新版本选型咨询

这个问题问得非常关键——选对API版本直接关系到你开发的应用能不能稳定、适配未来的WordPress生态，咱们一步步拆解清楚：

v1（遗留版本） #

• 资源支持极度有限：只覆盖了文章、用户、媒体这类基础资源，分类、标签、评论、自定义文章类型这些都完全不支持。
• 端点结构不统一：用的是/wp-api/posts这类简单但混乱的路径，没有后续版本的标准化前缀。
• 定制与过滤能力薄弱：几乎没什么可用的查询参数，也不支持自定义字段，对返回数据的控制非常有限。
• 已彻底停止维护：这个版本早就被官方废弃了，不会再有任何安全补丁或功能更新，新项目用它风险极高。

v2（重大改版版本） #

• 标准化端点结构：引入了/wp/v2/前缀（比如/wp/v2/posts、/wp/v2/categories），这也是现在API的基础架构。
• 资源覆盖全面：新增了评论、分类法、自定义文章类型、元字段等支持，基本能满足大多数WordPress集成需求。
• 过滤与灵活性大幅提升：加入了per_page、author、category等大量查询参数，还能通过_fields控制返回字段的包含或排除。
• 支持JSON Schema：所有端点都附带了Schema定义，方便验证请求/响应数据，也更容易构建工具类。
• 权限控制更严谨：和WordPress核心的权限体系深度对齐，编辑文章这类操作会严格遵循用户角色权限。

v3（当前稳定版本） #

• 性能优化显著：重构了内部逻辑，减少了数据库查询次数，处理大数据集时响应速度更快。
• 安全性增强：修复了边缘场景下的漏洞，优化了认证处理（更好支持应用密码和OAuth2），同时收紧了输入验证规则。
• 适配块编辑器（Gutenberg）：新增了对块特定数据的支持，比如获取块内容结构、处理和块关联的元字段。
• 端点行为精细化：调整了部分现有端点（比如改进批量操作支持、统一错误响应格式），还根据社区反馈增加了一些小功能。
• 向下兼容v2：v2的核心端点在v3里几乎可以直接使用，从v2迁移到v3的成本极低。

简单说：不是强制要求，但新项目绝对应该优先选它，原因如下：

• v1完全不能用：如前所述，它已经被废弃，有已知安全漏洞，没有任何理由在新项目中使用。
• v2虽可用但已停滞：v2目前还没被废弃，但官方不会再给它加新功能或重大安全更新，后续只会有极少的bug修复。
• v3是未来方向：它是当前官方维护的稳定版本，所有WordPress核心新功能（尤其是和块编辑器相关的）都会基于v3开发，也是社区重点投入的版本。
• 迁移成本极低：如果你原本考虑用v2，切换到v3几乎不需要改代码，因为v3完全兼容v2的核心端点。

唯一可能不用v3的场景是：你必须支持极旧的WordPress版本（大概5.0之前），这些版本没有内置v3。但即便如此，这些旧版本本身也已经停止维护、存在安全问题，更合理的做法是建议用户升级WordPress，而不是为过时软件做适配。

内容的提问来源于stack exchange，提问作者Mulli