最近在维护 WordPress 网站时，遇到一个很典型的问题：
文章详情页顶部莫名其妙出现一段 “阅读更多” 纯文本，网页结构错乱，同时查看网页源代码发现 meta description、og:description 里也带有 HTML 标签或多余文字，严重影响 SEO 与社交分享展示。
经过排查，问题并非来自代码报错，而是 WordPress 摘要机制 + 主题（GeneratePress）+ SEO 插件共同作用导致的。下面把完整原因和修复方案分享出来。
一、问题表现
- 文章详情页顶部直接出现裸露的 “阅读更多” 文字，没有任何样式包裹
- 网页源代码中：
<meta name="description"内容不干净<meta property="og:description"带有 HTML 标签
- 手动填写文章摘要后，错乱消失，但列表页 “阅读更多” 按钮也不见了
- 社交分享（Facebook、Telegram 等）预览文案异常
二、根本原因
- WordPress 自动摘要会把 “阅读更多” 按钮一起抓取进去 主题（如 GeneratePress）在文章摘要末尾自动添加
<a>阅读更多</a>链接，属于 HTML 代码。 - SEO 插件或系统自动抓取摘要作为 Meta 描述 当系统或 Yoast 等插件生成 meta/og 描述时，直接把这段带 HTML 的摘要放进去，浏览器解析异常，导致文字溢出到页面顶部。
- 手动摘要会隐藏阅读更多按钮 WordPress 与 GeneratePress 原生规则：手动填写摘要 = 不显示阅读更多按钮 这就造成 “不乱就没按钮，有按钮就乱” 的矛盾。
三、不依赖任何 SEO 插件的纯代码修复
以下方案适用于 GeneratePress 及大多数 WordPress 主题，无需插件、不改动核心文件，直接丢进主题 functions.php 底部即可。
// 1. 清除摘要内自带的“阅读更多”链接，避免meta标签乱码、列表重复文字
add_filter( 'wp_trim_excerpt', function( $text ) {
$text = preg_replace('/<p class="read-more-container">[\s\S]*?<\/p>/', '', $text);
$text = preg_replace('/\.\.\.<a.*?>阅读更多<\/a>/', '', $text);
$text = preg_replace('/<a[^>]*>阅读更多<\/a>/', '', $text);
return $text;
}, 999 );
// 2. 关闭GP原生阅读更多输出，防止重复
add_filter( 'generate_show_excerpt_more', '__return_false' );
// 3. 首页/分类/归档列表 强制末尾追加【查看全文】按钮，自动/手动摘要全部生效
add_filter( 'get_the_excerpt', function( $excerpt_content ) {
// 后台编辑页、文章详情页不追加
if ( is_admin() || is_single() || is_page() ) {
return $excerpt_content;
}
// 拼接按钮HTML
$read_more_btn = sprintf(
'<p class="read-more-container"><a href="%s" class="read-more button">查看全文</a></p>',
esc_url( get_permalink() )
);
return $excerpt_content . $read_more_btn;
}, 999 );
// 4. 过滤Yoast meta/og描述，彻底根除页面顶部漂浮文字
add_filter( 'wpseo_metadesc', function( $desc ) {
return trim( wp_strip_all_tags( $desc ) );
}, 99 );
add_filter( 'wpseo_opengraph_desc', function( $desc ) {
return trim( wp_strip_all_tags( $desc ) );
}, 99 );1. 清理摘要，移除阅读更多 HTML
从源头去掉摘要里的按钮代码，让 Meta 描述保持纯文本。
2. 自动生成干净的 Meta 与 OG 描述
自动截取文章前 N 个字作为描述，不带任何标签。
3. 强制列表页始终显示阅读更多按钮
无论是否手动填写摘要，列表页都保留按钮，不影响点击与 SEO。
四、修复后效果
- 文章详情页不再出现裸露文字，网页结构恢复正常
- Meta 描述、og:description 干净纯文本，SEO 友好
- 社交分享预览正常，无乱码、无多余标签
- 自动摘要、手动摘要都正常使用
- 首页 / 分类页永远显示 “阅读更多 / 查看全文” 按钮
五、总结
WordPress 出现网页格式错乱，90% 不是程序崩溃，而是摘要、HTML 标签、Meta 输出三者冲突。只要把摘要里的 HTML 清理掉，再强制输出纯文本描述，问题一次性解决。
如果你也在用 GeneratePress 或者遇到类似的格式错乱、SEO 描述异常，不妨直接用这套方案，稳定、通用、一劳永逸。