本文介绍在 WordPress 中不依赖过滤钩子（filter hook）的情况下，通过 get_the_content() 结合字符串截取函数，安全、可控地限制归档页文章描述的显示字符数，并提供完整示例与关键注意事项。
本文介绍在 wordpress 中不依赖过滤钩子（filter hook）的情况下，通过 `get_the_content()` 结合字符串截取函数，安全、可控地限制归档页文章描述的显示字符数，并提供完整示例与关键注意事项。
在 WordPress 主题开发中，归档页（如首页、分类页）常需展示文章摘要而非全文。若直接使用 the_content() 会输出完整内容且已应用所有编辑器格式和短代码，难以精确控制字符长度；而 substr() 等简单截断又易破坏 HTML 结构或截断在标签中间，引发页面错位。
推荐做法是：改用 get_the_content() 获取原始内容字符串，再进行安全截取。该函数返回未经过 the_content 过滤器处理的纯内容（不含自动段落 <p></p> 包裹、短代码解析等），便于开发者自主控制输出逻辑。
以下为整合进您原有 WP_Query 循环的完整示例：
<?php
$args = array(
'posts_per_page' => 3,
'offset' => 0,
'orderby' => 'post_date',
'order' => 'DESC',
'post_type' => 'post',
'post_status' => 'publish'
);
$query = new WP_Query($args);
if ($query->have_posts()) :
while ($query->have_posts()) : $query->the_post();
$content = get_the_content();
// 移除短代码、HTML 标签，保留纯文本（更安全的截取基础）
$plain_text = wp_strip_all_tags($content);
// 截取前 120 个字符（可根据需求调整）
$limited_content = mb_substr($plain_text, 0, 120, 'UTF-8');
// 可选：添加省略号并确保不截断单词
if (mb_strlen($plain_text) > 120) {
$limited_content = rtrim($limited_content) . '…';
}
?>
<p><?php echo esc_html($limited_content); ?></p>
<?php endwhile;
wp_reset_postdata(); // ⚠️ 关键：重置全局 $post 对象
endif;
?>✅ 关键说明与注意事项：
- 使用
mb_substr()替代substr()，确保多字节字符（如中文）不被截断乱码； - 必须调用
wp_strip_all_tags()预处理内容，避免 HTML 标签干扰字符计数及前端渲染； - 输出前务必使用
esc_html()转义，防止 XSS 风险； -
wp_reset_postdata()不可省略，否则后续模板逻辑可能读取错误的$post数据； - 若需保留部分格式（如粗体、链接），应改用
wp_trim_words()（基于词数截取，自动处理 HTML）或结合wp_kses()白名单过滤，而非纯字符截断。
综上，无需 filter hook 即可实现精准字符限制——核心在于“获取 → 清洗 → 截取 → 转义 → 输出”的四步安全链。
