本文介绍如何使用 excerpt_more 钩子精准替换 WordPress 默认摘要末尾的 [...]，将其改为可点击的 HTML 链接（如 (more)），并提供完整、安全、主题友好的实现方案。
本文介绍如何使用 `excerpt_more` 钩子精准替换 wordpress 默认摘要末尾的 `[...]`，将其改为可点击的 html 链接（如 `(more)`），并提供完整、安全、主题友好的实现方案。
在 WordPress 主题开发中，the_excerpt() 函数默认会在截断内容后追加一个静态字符串 [...]，用于提示用户还有更多内容。但该符号纯文本、无语义、不可交互，无法引导用户跳转——这显然不符合现代用户体验需求。
要修改这一行为，不能使用 excerpt_length（它仅控制字数），而应使用 WordPress 官方提供的 excerpt_more 过滤钩子。该钩子专门用于定制摘要末尾的“更多”标记，且在 get_the_excerpt() 内部被调用，时机精准、兼容性高。
以下是推荐的实现方式：
function mytheme_excerpt_more( $more ) {
// 仅在非管理后台、且当前文章有有效链接时生成可点击链接
if ( ! is_admin() && get_the_ID() && get_permalink() ) {
$more = sprintf(
'<a href="%1$s" class="excerpt-read-more" rel="nofollow">%2$s</a>',
esc_url( get_permalink() ),
esc_html__( '(more)', 'mytheme' )
);
} else {
$more = '…'; // 后台预览或无链接时回退为省略号
}
return $more;
}
add_filter( 'excerpt_more', 'mytheme_excerpt_more', 10, 1 );✅ 关键说明：
- 优先级设为 10（默认值）已足够，无需盲目提高；若需覆盖其他插件逻辑，再考虑调整（如 11）。
- 使用 esc_url() 和 esc_html__() 确保输出安全，符合国际化（i18n）规范。
- 添加 rel="nofollow" 可避免 SEO 权重误传递（尤其在列表页大量出现时）。
- 判断 ! is_admin() 避免后台编辑器中意外渲染链接，提升管理体验。
⚠️ 注意事项：
- 此钩子仅影响 the_excerpt() 及其衍生函数（如 get_the_excerpt()）；若主题直接调用 wp_trim_words() 或手动截取内容，则需另行处理。
- 若启用了「自定义摘要」（即手动填写了 Excerpt 编辑框），WordPress 将不触发 excerpt_more ——因为此时内容未被自动截断。如需统一处理，建议结合 get_the_excerpt 钩子做二次封装。
- 如需样式控制，可在主题 CSS 中添加：
.excerpt-read-more { color: #0073aa; text-decoration: none; font-weight: 500; } .excerpt-read-more:hover { text-decoration: underline; }
通过此方案，你不仅能优雅替换 [...]，还能赋予其语义化结构、可访问性支持与主题一致性，是构建专业 WordPress 主题的标准实践之一。
