WordPress 7.1（代号 Mary Lou）在 8 月 19 日发布，落地时间是 WordCamp US 的闭幕当天。官方给出的数字是修复了 180 多个核心 bug、630 多个编辑器 bug，另有一百多项功能改进。
版本号跳得快，站长的第一个问题往往不是「有什么新功能」，而是「我这一升会不会出问题」。这篇不堆功能清单，只说升级前要查什么、升的过程中看什么、出了问题怎么退。
一、这次改动里，四处会碰到你站上
先把会直接影响现有站点的变化挑出来，其余锦上添花的功能可以慢慢试。
第一处是文章编辑器全面 iframe 化。以前内容里如果用了低版本的区块 API，编辑器会退回非 iframe 模式；7.1 取消了这个兼容行为，无论主题类型、区块 API 版本、有没有传统 meta box，文章编辑器都强制跑在 iframe 里。只写文章的人感觉不到，装了自定义区块或编辑器扩展的站就得先测这一处——老写法里用 document.querySelector 直接抓编辑器元素的代码，现在抓到的可能是后台页面而不是画布。
第二处是图片处理挪到了浏览器端。压缩、缩放、生成缩略图改用 WebAssembly 版的 libvips 在浏览器里跑，服务器的内存和超时压力小一截，传大图不容易再撞 PHP 的内存上限。代价是这步依赖浏览器能力，走了严格 CSP 的站要留意处理进程的资源加载；官方保留了自动降级，但降级意味着这项优化没生效。
第三处是全局样式新增响应式与伪状态支持。主题现在可以在 theme.json 里给按钮这类元素单独定义 hover、focus、focus-visible、active 四种状态，也能按屏幕尺寸分开设样式。要注意它是叠加式的——不会删掉你主题自己的断点和 CSS，于是可能出现编辑器预览正常、前台却和主题样式打架的情况。
第四处是两个新区块加一批依赖升级。新增 Tabs（标签）和 Playlist（播放列表）区块；jQuery UI 升级到 1.14.2，移除了一批老旧接口；编辑器组件库里也删掉了若干弃用组件。后台用了日期选择器、弹窗、拖拽排序的老插件，属于重点观察对象。
二、哪些站可以直接升，哪些站必须测
按风险分三档更省事。
用默认主题加主流通用插件、没有自定义代码的站，风险低，正常备份后升就行。
用了自定义区块、深度改过编辑器或后台的站，iframe 那处变化是硬变化，重点看浏览器控制台有没有报错。
主题自己实现了一套响应式断点或按钮样式体系的站，重点测前台渲染，别只看编辑器预览，两边的表现可能不一致。
判断标准就一句话：站上有没有直接操作编辑器 DOM 的代码，有没有依赖老 jQuery UI 的后台功能。两样都没有，基本可以直接升。
三、升级动作按这个顺序走
1. 备份文件和数据库，并且真的试一次恢复。备份文件存在和备份能用是两件事。
2. 建一个测试站，主题、插件、PHP 版本、内容都对齐生产环境。
3. 在测试站先升主题和插件，再升 WordPress 核心。
4. 打开几篇带自定义区块、自定义字段的旧文章，看编辑器能否正常打开、控制台有没有报错。
5. 上传一张大图，测媒体库的压缩和缩略图生成。
6. 过一遍响应式的代表性页面：导航、栏目、分组、按钮、图片。
7. 以上没问题再升生产。升之前记下当前版本号和已装插件版本，留着回退。
回退预案直接一点：保留升级前的整站备份和数据库导出，真出问题时还原文件加导入数据库，比逐个回滚插件快得多。
四、给它做一次自动扫描
手工点页面难免遗漏。可以在服务器上跑一条扫描命令，把最容易踩坑的老式写法找出来。
在站点根目录执行下面这条命令。
# 在站点根目录执行；扫主题和插件里三类老式写法：
# 直接抓编辑器/全局 document、老 jQuery UI 接口、旧编辑器 API
grep -rnE "document\.querySelector|window\.document|\$\.ui\.safe|wp\.oldEditor|\.datepicker\(" \
wp-content/themes wp-content/plugins \
--include="*.js" --include="*.php" | head -40
这条命令干什么用：在主题和插件目录里搜三类与 7.1 改动直接相关的写法。要改哪里：如果你的主题目录不在 wp-content/themes 下，把路径换成实际路径。跑完看什么：命中集中在少数几个插件上，先去查这几个插件有没有适配 7.1 的新版本；命中出现在你自己的子主题或自建插件里，那就是升级前必须手改的地方。
再顺手看一眼版本情况，确认核心和插件都在什么状态。
# 看当前核心版本，并列出有可用更新的插件
wp core version
wp plugin list --update=available --fields=name,version,update_version
这段命令干什么用：第一行确认核心版本，第二行列出版本落后于官方仓库的插件。要改哪里：不需要改，前提是服务器上装了 WP-CLI。跑完看什么：核心还没到 7.1 的，先确认是不是你手动锁定了版本；插件列表里那些长期停在老版本的，升级前单独去官网看兼容说明。
7.1 不属于那种不升就出大事的版本，它没有捆绑强制安全修复，所以你有时间在测试站上把它跑一轮。真正要提前处理的只有 iframe 编辑器这一项——它对改过编辑体验的站是硬变化，早测早省事。其余的，等测试站跑稳了再动生产也不迟。
A5创业网 版权所有