结论先说：Gutenberg 24.2（2026 年 10 月 14 日发布）里真正会让你「今晚就得动手」的只有一件事——React 19 在这个版本默认开启。其余改动都属锦上添花：图库支持排序和整组双色调、设计工具的最小宽高从 5 个区块扩到 40 个、协作笔记搬到画布边缘。如果你只维护自建站、不追 Gutenberg 插件，可以等它随 WordPress 7.2 正式版进来再动；如果你是主题或插件作者，现在就该在 24.2 上跑一遍回归。
这个版本包含约 80 个设计工具相关的 PR 和 60 多个错误修复，改动面很宽但都很碎。下面按「会影响你的程度」重排一遍，而不是照搬官方更新日志的顺序。
一、 React 19 默认开启：唯一需要立刻验证的改动
从 24.2 起，站点默认加载 React 19 的 react 与 react-dom 脚本。官方保留了一条退路：检测到已知不兼容的主题或插件时，仍回落到 React 18，不兼容清单来自 WordPress.com 并在本版继续扩充。
这条退路的边界很关键——它只覆盖「清单上已知」的插件。你自己写的、或小众插件里的不兼容，不会被自动识别。 React 19 移除了一批长期弃用的 API（如旧版的 defaultProps 写法、部分 legacy context 行为），受影响的多是「顺手改过编辑器界面」的插件。
| 症状 | 常见原因 | 处理方式 |
|---|---|---|
| 区块设置侧边栏空白 | 组件用了被移除的旧 API | 临时关掉 React 19，再定位具体插件 |
| 控制台报 invalid hook call | 同一份 React 被打包了两遍 | 检查插件是否自带 React 副本，改为依赖 wp-element |
| 自定义区块样式错乱 | inert 属性写法变更 | 改用新包 @wordpress/react-inert-value |
先别急着升级，先用一条命令摸清自己站上有哪些东西在碰 React：
grep -rl "wp-element" wp-content/plugins wp-content/themes \
--include="*.php" | head -20命中的插件就是需要重点测的对象。wp-element 是 WordPress 对 React 的封装，凡是用它的地方都会跟着 React 19 一起变。确认有问题后，可以在 Gutenberg 的 Experiments 面板里关掉 React 19 应急——但这是临时措施，不是长期方案。
二、图库终于能排序了，双色调可以一次刷全图
图库（Gallery）区块这次拿到两个实用能力：
- Order by 控件：手动挑选的图库现在能按「最新到最旧／最旧到最新／A→Z／Z→A 」一次性排序，排完之后仍然可以继续拖拽微调。随机（Random）也挪进了同一个控件，且是前端每次加载都重新打乱。
- 整组双色调（duotone）：一个滤镜作用于图库内所有图片，可以在区块设置里配，也可以在全局样式里配。单张图片自己设了双色调时，优先级高于图库级别。
这两条放在一起看，意义不只是「方便」。过去做图片墙最麻烦的是色调不统一——十几张来源不同的图放一起，颜色各说各话，只能一张张调，或者干脆在外部先批量调色再上传。现在整组一个滤镜就能压住，而且改一次全局生效。
实践上建议把双色调放在全局样式里而不是单个图库上：这样以后新增的图库会自动继承，不用每建一个就配一遍。单张图要突出时再单独覆盖。
三、设计工具一致性：最小宽高从 5 个区块扩到 40 个
这是本版 PR 数量最多的一块，官方说法是「继续推进设计工具一致性」。翻译成人话：过去只有少数区块能调的样式，现在大部分区块都能调了。
| 能力 | 本版扩展到 |
|---|---|
| 最小宽度 / 最小高度 | 从 5 个区块扩到约 40 个，含 Buttons 、 Columns 、 Heading 、 Media & Text 、 Post Title |
| 阴影 | 新增 10 个区块，含 Paragraph 、 List 、 Buttons 、 Social Icons 、 Gallery |
| 双色调 | 新增 Gallery 、 Media & Text 、 Video |
| 背景图与渐变 | 新增 Button 、 List 、 List Item 、 Media & Text |
| 行缩进 | 新增 Heading 、 Post Author Biography 、 Poetry |
需要提醒的风险是样式面板变长。可调项变多，不等于该调项变多。一个页面上如果每个段落都单独设阴影、每个按钮都单独设渐变，主题的全局样式就形同虚设，以后换配色要改几十处。建议约定一条底线：能在全局样式里定的，就不要在单个区块上定，单个区块只做例外覆盖。
顺带被改掉的几个交互
- Columns 移除了列数滑块：改用工具栏的加号增列，删除列和其他区块一致。习惯拖滑块的人会不适应，但一致性确实更好。
- Button 的链接弹窗改为按需打开：只有点 Link 或用快捷键才弹，不再一点按钮就冒出来。
- 图片可以恢复原图：裁剪之后，在媒体编辑器的更多选项里能选「 Restore original image 」，不用重新上传。
- 图标库支持关键词搜索：搜 hamburger 能找到 Menu 图标，搜 gear 能找到 Settings 。
四、协作笔记搬到了画布边上
多人在线协作的笔记（Notes）从设置侧边栏挪到了编辑器为画布预留的边距里。这个改动的实际收益是：切换区块或切换文章设置时，笔记不会消失——以前一边看图一边看评论要来回切面板，现在两者同屏。
配套细节也补齐了：画布变窄时每条讨论会缩成作者头像，点头像展开；删除笔记有「撤销」；切换区块时会保留没发出去的草稿；笔记随画布一起滚动。 Options 菜单里新增了 Notes 子菜单，可以展开、最小化或隐藏，编辑器会记住你的选择。
如果你团队用笔记做审稿批注，这套改动值得试。但要注意它仍属协作实验范畴，正式流程上的批注最好还是落在任务系统里，别只存在于编辑器里。
五、导航与搜索：一次搜完所有内容类型
导航区块的链接搜索过去只能搜页面，现在一次能搜页面、文章、分类、标签等所有内容类型，结果旁边会标出类型，结果也按类型排序（文章／页面优先于分类／标签／媒体）。切换一个已有链接的类型，不用删掉再加。搜索结果里还会列出导航能接受的区块——输入 Home 能找到 Home Link 区块。
另一处和导航相关：全局样式现在可以给导航链接的 hover 、 focus 、 focus-visible 、 active 四种状态分别设样式。这是可访问性层面的实事——键盘用户终于能看到明确的焦点态了。
六、 Interactivity API 的两处新增
对开发者来说，这版有两个接口变化：
data-wp-html指令：从 store 渲染 HTML，类似data-wp-text但输出的是标记而不是纯文本。安全上做了限制——只接受经过asDangerousHTML()显式标记为可信的值。这个设计是对的：把「我知道这里有风险」变成代码里必须写出来的一行，而不是靠人记得。- Router 增加
state.navigating与state.initiator：可以知道客户端导航是否正在进行、以及是哪个区块发起的。做加载态和局部刷新时不用再自己维护标志位。
另外，视频和封面区块在系统开启「减少动画」时会停止自动播放（编辑器内和前端都生效）。这是无障碍改进，但也意味着把视频当首屏背景的站点，在部分用户那里会变成静止图。如果你的首屏视频承载关键信息，得准备一张能独立讲清事情的封面图。
七、升级前该走的检查清单
- 在测试环境装 Gutenberg 24.2（不要在正式站直接开），先只启用核心插件，确认后台能正常打开区块编辑器。
- 用 grep 扫出所有引用 wp-element 的主题与插件，列成清单，逐个启用后打开区块编辑器看控制台。
- 打开一个含图库的页面，验证排序控件行为和双色调效果，特别确认单图双色调是否优先于图库级设置。
- 打开导航区块，试一次跨类型搜索（搜一篇文章标题、再搜一个分类名），确认结果类型标注正确。
- 如果有自定义区块，重点测链接弹窗、 Columns 增删列、以及任何用到 inert 属性的地方，这是本版改动最集中的几处。
我不想追 Gutenberg 插件，等 7.2 正式版行不行？
行。 Gutenberg 是核心功能的试验田，24.2 的东西会分批进入 WordPress 7.2 。但注意两点：一是 React 19 一旦进核心就没有实验开关可关了，二是设计工具的一致性改动会改变你现有页面的样式面板结构。所以在 7.2 Beta 阶段就要测，而不是等正式版。
图库排序会不会打乱我手工排好的顺序？
不会自动打乱。 Order by 只在你主动选择排序方式时生效，排完之后仍然可以拖拽微调。唯一需要留意的是「随机」选项——它是前端每次加载都重新打乱，如果你要固定顺序，别选它。
把 24.2 放进 WordPress 7.2 的时间线里看会更清楚：这个版本基本是在为 7.2 收口设计工具的一致性，同时把 React 19 从实验推向默认。WordPress 7.2 默认关闭 NO_BACKSLASH_ESCAPES 的那篇讲了另一个方向的破坏性变更，两件事叠在一起，说明 7.2 会是一个「升级前必须做功课」的版本。如果你刚开始接触区块开发，可以先看用 create-block 构建第一个区块把基础打通，再回来看这些接口变化会轻松很多。上一版的功能梳理在Gutenberg 23.9 的更新解读里，对照着看能看出设计工具这条线是怎么一步步铺开的。
Gutenberg 24.2 是正式版吗？普通站长需要装吗？
Gutenberg 是官方插件，相当于核心功能的前置试验场，不属于必须安装的组件。只维护内容、不写代码的站长可以不装，等功能随 WordPress 7.2 进入核心即可；主题和插件作者建议现在就装来测兼容性。
React 19 默认开启后，我的老插件一定会坏吗？
不一定。官方维护了一份已知不兼容清单，命中清单时会自动回落到 React 18 。风险在于清单之外的插件——尤其是自己改过编辑器界面的那些。用 wp-element 关键字扫一遍再逐个测，比直接上线赌运气可靠。
整组双色调和单图双色调冲突时谁生效？
单张图片自己的双色调设置优先。所以你可以用图库级双色调做统一色调，再对需要突出的那一两张单独覆盖，不会被组级设置压掉。
协作笔记挪位置之后，旧的使用习惯要改吗？
主要变化是笔记不再挤在设置侧边栏，而是常驻在画布旁边，切换区块也不会消失。画布窄的时候会缩成作者头像，点头像展开。 Options 菜单里能控制展开、最小化或隐藏，编辑器会记住你的选择。
data-wp-html 会不会带来 XSS 风险？
接口本身做了约束：只渲染经过 asDangerousHTML() 显式标记的值，等于把风险声明写进代码。真正的风险来自你把用户输入直接标记为可信——那和在任何模板里直接输出未转义内容是一样的问题。
评论 (0)