WordPress 中文摘要为什么撑坏首页卡片?本站的一次修复

3 阅读4分钟

观言引擎官网的一张文章卡片突然变得很长,中间几乎塞进了整篇文章。相邻卡片没有同样的问题,所以这次没有先改全站字号,也没有给所有卡片强行加固定高度。

这篇记录对应观言引擎官网维护,发生在 2026 年 10 月 10 日。以下尺寸只描述当次页面和测试视口,不代表所有 WordPress 主题都会出现相同结果。

先比较卡片实际拿到了多少文字

出问题的文章没有填写手动摘要。首页通过摘要接口取内容,输出的中文文本远超设计预期。WordPress 默认摘要截取通常按词数处理,具体行为也受语言设置和过滤器影响。中文正文没有英文那样明显的空格分词,不能直接把一个词当作一个汉字计算。

这次的关键证据是卡片拿到的摘要过长。图片尺寸和文章标题并不是主要原因。

给这篇文章补上 61 个字符的手动摘要后,首页该卡片恢复到正常长度,文章详情页正文保持完整。只改 CSS 能暂时遮住文字,但摘要数据本身仍然不适合用于列表。

手动摘要之后,还需要限制输出

只修这一篇,后续新文章忘记填摘要时,问题仍可能出现。本站因此在 get_the_excerpt 过滤器中增加纯文本长度限制:先去掉 HTML 标签,再整理空白字符,按 Unicode 字符拆分,超过 120 个字符时截断并追加省略号。

这里采用字符数,是为了避开中文正文缺少空格带来的截取差异。120 是本站卡片的维护约定,并非搜索引擎要求。

这种处理也有边界。Unicode 字符截取不能完全等同于用户感知的字形,组合 emoji 可能被拆开。如果站点摘要常含复杂 emoji,需要再评估按字素簇截取的方案。当前主要内容为中文技术说明,所以先保留较简单的实现。

本站过滤器使用较高优先级,减少前面的摘要处理把长度重新放大的可能。但这并不保证它是最后一个过滤器;如果其他插件随后再次改写摘要,还需要核对最终输出。

390 像素宽度下,还要看详情页

以下是本次采用的摘要兜底写法。它只处理摘要接口,不替换文章正文:

add_filter('get_the_excerpt', function ($excerpt) {
    $text = trim(preg_replace('/\s+/u', ' ', wp_strip_all_tags($excerpt)));
    $chars = preg_split('//u', $text, -1, PREG_SPLIT_NO_EMPTY);
    if ($chars !== false && count($chars) > 120) {
        return implode('', array_slice($chars, 0, 120)) . '…';
    }
    return $text;
}, 99);

如果项目要求按完整字形截取,以上实现就不够了;也别把 120 直接当作所有页面的统一标准。

补摘要并加入限制后,桌面首页的六篇文章摘要长度为 60—82 个字符,首行卡片高度为 331 像素。在 390 像素宽的测试视口下,卡片高度为 297—327 像素,没有发现横向溢出。

这些数据用于记录修复后的状态。文章标题长度不同,卡片不必完全等高,检查重点是正文是否挤出容器、操作入口能否正常点击。

手机测试结束后恢复了浏览器视口设置,并再次确认详情页正文没有被摘要过滤器截断。这一步不能省略:列表摘要需要短,文章正文仍要完整。

后续发布多检查一个字段

这次修复后,发布文章时会单独准备摘要,直接说明文章讨论什么。系统截断保留为兜底,避免一次漏填影响首页。

还应记录过滤器的作用范围。get_the_excerpt 可能被多个模板调用,这次加入的限制会影响使用该接口的摘要位置。若以后有页面需要更长摘要,应按模板另作安排。

排查类似问题,可以从一张异常卡片开始,比较它与相邻卡片的实际文本。先确认输出内容,再判断布局是否还有问题,会比不断调整高度和行距更容易找到原因。

观言引擎是湖北的独立服务品牌,目前尚未注册公司。这是我们自己网站的维护记录,不是客户案例。相关资料保存在 官网公开资料页。本文使用 AI 辅助整理,代码与测试结论依据本次实际修复记录。