本文详解如何通过 pre_get_posts 钩子安全、高效地提升 wordpress 标签页和分类页的每页文章数，并避免常见错误（如误判归档类型、影响后台查询或布局错乱）。
本文详解如何通过 pre_get_posts 钩子安全、高效地提升 wordpress 标签页和分类页的每页文章数，并避免常见错误（如误判归档类型、影响后台查询或布局错乱）。
在 WordPress 主题开发与站点优化中，默认的归档页（如标签页 /tag/example/ 或分类页 /category/news/）通常每页仅显示 10 篇文章。当内容量增大时，用户需频繁翻页，影响体验。此时，合理扩展每页文章数量（例如设为 20 篇）是常见需求。但实现时需格外注意钩子使用方式——绝不能在主循环前盲目修改全局查询对象，否则易导致缩略图错位、标题换行异常等前端渲染问题（正如提问者所遇）。
核心原则是：仅对前台的、明确的标签或分类归档页面生效，且必须排除后台查询与主循环以外的次要查询（如侧边栏小工具中的 recent posts）。因此，推荐使用 WordPress 内置的条件函数 is_tag() 和 is_category()，而非依赖 $query->is_tag 这类未初始化或不可靠的查询属性（该属性在部分上下文中可能为 null 或未设置，导致逻辑失效）。
以下是推荐的完整实现代码，可直接添加至当前主题的 functions.php 文件末尾：
add_action( 'pre_get_posts', 'increase_archive_posts_per_page' );
function increase_archive_posts_per_page( $query ) {
// 仅作用于前台、主查询、且为标签或分类归档页
if ( ! is_admin() && $query->is_main_query() ) {
if ( is_tag() || is_category() ) {
$query->set( 'posts_per_page', 20 );
}
}
return $query;
}✅ 关键说明：
- 使用 is_admin() 排除后台请求，防止影响文章编辑、仪表盘等管理功能；
- 使用 $query->is_main_query() 确保仅修改主循环查询（即页面主体内容），避免干扰导航菜单、相关文章、小工具等次要查询；
- is_tag() 和 is_category() 是可靠的模板条件函数，语义清晰、兼容性强；
- 若还需支持自定义分类法（如产品类型 product_cat），可扩展为 is_tax('product_cat')。
⚠️ 注意事项：
- 修改后务必清空对象缓存（如使用 WP Super Cache、Redis 等插件），并刷新浏览器缓存；
- 若主题采用 AJAX 加载分页（如“无限滚动”），需同步检查 JS 分页逻辑是否兼容新 posts_per_page 值；
- 不建议无限制提高数值（如设为 100+），将显著增加单页 DOM 负载与首屏渲染时间，建议结合分页体验与性能监控综合权衡。
综上，正确使用 pre_get_posts 钩子配合精准的条件判断，是 WordPress 归档页定制的最优实践。它不改动模板结构、不影响原有样式逻辑，真正实现“零侵入式”增强。
