![WordPress 中自定义文章摘要末尾省略符（[...]）的完整教程](https://img.php.cn/upload/article/001/246/273/178497024970716.jpg)
本文详解如何使用 excerpt_more 钩子精准替换 wordpress 默认摘要末尾的 [...]，支持纯文本、html 链接及多语言适配，并提供可直接部署的代码示例与最佳实践。
本文详解如何使用 excerpt_more 钩子精准替换 wordpress 默认摘要末尾的 [...]，支持纯文本、html 链接及多语言适配，并提供可直接部署的代码示例与最佳实践。
在 WordPress 主题开发中，文章摘要（excerpt）末尾默认显示 [...] 作为截断提示。但该符号既无语义、也不利于 SEO 和用户体验——它无法点击，也不支持翻译。幸运的是，WordPress 提供了专用的 excerpt_more 过滤钩子（filter hook），专用于定制这一占位符，无需修改核心文件或依赖 JavaScript。
✅ 正确用法：使用 excerpt_more 钩子
excerpt_length（如问题中所示）仅控制摘要字数，不处理末尾标记；真正负责 [...] 替换的是 excerpt_more。该钩子接收原始 $more 参数（默认值即 '[...]'），允许你返回任意字符串或 HTML。
以下是一个生产就绪的示例，将 [...] 替换为带语义、可访问、支持翻译的「继续阅读」链接：
function mytheme_excerpt_more( $more ) {
// 移除默认 [ ... ]，生成语义化链接
return sprintf(
'<a href="%1$s" class="excerpt-read-more" rel="bookmark">%2$s</a>',
esc_url( get_permalink() ),
esc_html__( '继续阅读 →', 'mytheme' )
);
}
add_filter( 'excerpt_more', 'mytheme_excerpt_more', 10 );? 关键说明：
- get_permalink() 在 excerpt_more 钩子中可安全调用，自动获取当前文章 ID；
- 使用 esc_url() 和 esc_html__() 确保输出安全且支持主题翻译（需在 functions.php 中已加载文本域）；
- 优先级设为 10（默认值）即可，无需像 excerpt_length 那样设为 999，除非有特殊冲突需求。
? 常见误区与注意事项
- ❌ 不要尝试在 the_excerpt() 输出后用 str_replace() 处理——这会破坏 HTML 结构，且无法在 get_the_excerpt() 等函数中生效；
- ❌ 避免直接返回裸 HTML 字符串（如 <a href="#">Read more</a>）而不做转义，存在 XSS 风险；
- ✅ 若需纯文本替代（如 … 或 （全文）），可简化为：
add_filter( 'excerpt_more', function() { return '…'; } ); - ✅ 如需对特定文章类型或分类禁用链接，可在回调函数中加入条件判断：
if ( 'product' === get_post_type() || is_category('news') ) { return '<span class="excerpt-ellipsis">…</span>'; }
? 总结
excerpt_more 是 WordPress 官方推荐、轻量且可靠的摘要末尾定制方案。相比硬编码或 JS 替换，它原生集成、性能优异、兼容所有 excerpt 调用方式（模板标签、REST API、块编辑器等）。只需一行 add_filter()，即可统一管理全站摘要引导行为，兼顾可访问性、国际化与维护性。建议将其纳入主题基础功能清单，并配合 wp_kses_post() 或 wp_strip_all_tags() 在必要时进一步净化输出。
