WordPress自定义主题获取文章摘要失败问题求助

数据老陈

2026-5-11

解决WordPress主题中文章摘要输出完整内容的问题

兄弟，我太懂你这种卡壳的憋屈感了！刚入坑WordPress主题开发时，我也在摘要这个环节踩过好几个坑，咱们一步步来排查解决：

先确认你用对了函数：别笑，新手最容易犯的错就是把 the_content() 和 the_excerpt()搞混！如果你想输出摘要，一定要在主题模板里用 <?php the_excerpt(); ?> 而非 the_content()。如果之前写错了，换过来应该就能看到效果。
检查文章是否设置了手动摘要：登录WordPress后台编辑文章，看看右侧有没有“摘要” metabox（如果没显示，去右上角“选项”里勾选“摘要”）。如果没填手动摘要，WordPress会自动截取文章前N个字符，但有时候主题或插件会干扰这个自动截取逻辑。你可以先手动写一段摘要试试，看前端能不能正常输出——如果可以，那问题大概率出在自动截取的配置上。
排查主题/插件的干扰：有些主题会重写 the_excerpt 的默认行为，SEO类插件也可能修改摘要的输出规则。你可以先暂时禁用所有插件，切换到WordPress默认主题（比如Twenty Twenty-Four），再看摘要是否正常。如果正常了，就逐个开启插件/换回自己的主题，找到哪个在搞鬼。
确认自定义摘要长度的代码是否正确：如果你用了钩子修改摘要长度，要确保代码放在主题的 functions.php 里，并且优先级足够高。比如：
```
function my_custom_excerpt_length( $length ) {
    return 25; // 改成你想要的字数
}
add_filter( 'excerpt_length', 'my_custom_excerpt_length', 999 );
```
这里的999优先级是为了覆盖默认的设置，确保你的代码生效。另外，如果你用了 wp_trim_excerpt() 函数手动生成摘要，也要检查参数是否正确。
处理短代码或特殊格式的干扰：如果文章里有很多短代码（比如[gallery]、[video]），自动截取时可能会把这些短代码的内容也带出来，看起来像是完整内容。你可以在输出摘要前过滤掉短代码，比如在 functions.php 里加这段代码：
```
function remove_shortcodes_from_excerpt( $excerpt ) {
    return strip_shortcodes( $excerpt );
}
add_filter( 'the_excerpt', 'remove_shortcodes_from_excerpt' );
```

按照这个顺序排查，应该能很快找到问题所在！

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