本文详解 WordPress 自定义 WP_Query 分页失效的根本原因（如未传递 max_num_pages、误用全局查询函数），并提供可直接复用的修复代码及关键注意事项，帮助开发者快速解决"分页始终显示第一页内容"的典型问题。 本文详解 wordpress 自定义 wp_query 分页失效的根本原因（如未传递 \`max_num_pages`、误用全局查询函数），并提供可直接复用的修复代码及关键注意事项，帮助开发者快速解决"分页始终显示第一页内容"的典型问题。在 WordPress 主题开发中，使用 WP_Query 实现自定义文章列表时，分页功能失效是一个高频问题------页面 URL 显示 /page/2/，但内容却与首页完全一致。根本原因在于：WordPress 的分页导航函数（如 next_posts_link() 和 previous_posts_link()）默认依赖全局 wp_query 对象，而自定义查询（如 all_catPosts = new WP_Query(args)）是独立实例，不会自动被这些函数识别。上述代码中，问题集中体现在两个关键位置：next_posts_link() 调用时传入了错误的参数：原代码中使用了未定义的 the_query->max_num_pages，应改为当前查询实例 $all_catPosts->max_num_pages； offset 参数与分页逻辑冲突：'offset' => 5 会强制跳过前 5 篇文章，但分页计算（paged=2）仍基于原始偏移量，导致数据重叠或错位。分页与 offset 不应共存------若需跳过固定数量文章，应改用 posts_per_page + paged 动态计算起始位置，或使用 post__not_in 排除特定 ID。? 正确修复后的核心代码如下（已优化结构与健壮性）： VWO 一个A/B测试工具