如何动态修改WordPress不同页面的每页文章数量？

问题诊断 #

你遇到的核心问题是$settings["postspage"]变量的取值异常：首页计算后只显示1篇，说明$settings["postspage"]在该场景下可能是null或非预期值（null + 1 = 1），而硬编码值正常，证明query_posts本身用法没问题，问题出在变量取值或类型上。

排查步骤 #

1. 确认变量实际内容：在代码中添加调试代码，查看$settings["postspage"]的真实值和类型：

   var_dump($settings["postspage"]);
   exit;
   

   访问首页后，若输出为NULL，说明$settings变量在首页未被正确初始化；若输出为带非数字字符的字符串（如"5 "带空格、"5\n"带换行），即使强制转int也可能因取值逻辑出错导致计算异常。

2. 替换为官方取值方式：WordPress获取后台默认文章数量的标准函数是get_option('posts_per_page')，它直接返回整数类型，能避免自定义变量的取值问题。

推荐实现方案（替代query_posts） #

WordPress官方不推荐使用query_posts()，它会破坏主查询的全局状态，容易引发后续逻辑错误。建议使用pre_get_posts钩子修改查询参数，更安全规范：

在主题的functions.php文件中添加以下代码：

add_action('pre_get_posts', 'custom_set_posts_per_page');
function custom_set_posts_per_page($query) {
    // 仅修改前台主查询，排除后台和自定义查询
    if (!is_admin() && $query->is_main_query()) {
        $default_count = get_option('posts_per_page');
        
        if (is_front_page()) {
            $query->set('posts_per_page', $default_count + 1);
        } elseif (is_tag()) {
            $query->set('posts_per_page', $default_count - 2);
        }
        // 其他页面保持后台默认设置，无需额外处理
    }
}

添加后无需修改模板文件的循环逻辑，钩子会自动在查询执行前修改文章数量参数。

原代码失效的可能原因 #

1. $settings["postspage"]并非全局可用变量，仅在特定页面被初始化，导致首页/标签页取值为null，计算后得到异常值。
2. query_posts()会覆盖主查询，若后续有其他代码（如主题/插件的查询逻辑）再次修改posts_per_page参数，会覆盖你的设置。
3. 自定义变量$settings["postspage"]存储的是字符串类型，即使强制转int，若存在隐藏非数字字符（如空格、换行），可能导致计算逻辑异常。

内容的提问来源于stack exchange，提问作者codade