WP Query调用自定义文章类型时仅显单篇且忽略分类的问题

你的代码目前存在两个核心问题：自定义分类的筛选参数使用错误，以及循环逻辑没有正确基于WP_Query结果，这才导致分类筛选失效且只显示单篇内容。下面是具体的修复方案：

1. 修正WP_Query的分类筛选参数 #

你使用的category_name参数是针对WordPress内置的「文章分类（Category）」的，但你的general是自定义文章类型documents的自定义分类，必须用tax_query来指定自定义分类法和分类别名。

首先确认你的自定义分类的分类法slug（创建自定义分类时设置的标识，比如你可能命名为document_categories），然后调整查询参数：

$args = array(
    'posts_per_page' => 50, // 设置足够大的数值确保展示所有符合条件的文章
    'post_type' => 'documents',
    'post_status' => 'publish', // 只显示已发布的文章
    'tax_query' => array(
        array(
            'taxonomy' => '你的自定义分类法slug', // 替换成你实际的分类法标识，比如document_categories
            'field' => 'slug',
            'terms' => 'general' // 目标分类的别名
        )
    )
);
$genral_documents = new WP_Query($args);

2. 修正循环逻辑 #

你之前错误地用the_field()来判断和遍历内容，这是ACF用于获取单字段值的函数，无法用来遍历WP_Query的查询结果。正确的循环应该基于WP_Query对象的内置方法：

<ul class="pdfLinks">
    <?php
    // 修正后的查询参数
    $args = array(
        'posts_per_page' => 50,
        'post_type' => 'documents',
        'post_status' => 'publish',
        'tax_query' => array(
            array(
                'taxonomy' => 'document_categories', // 替换为你的自定义分类法slug
                'field' => 'slug',
                'terms' => 'general'
            )
        )
    );
    $genral_documents = new WP_Query($args);

    // 检查是否有符合条件的文章
    if ($genral_documents->have_posts()) :
        while ($genral_documents->have_posts()) : $genral_documents->the_post(); ?>
            <li>
                <!-- 调用ACF自定义字段，示例为标题和PDF链接 -->
                <a href="<?php the_field('pdf_file'); ?>" target="_blank">
                    <?php the_field('title'); ?>
                </a>
            </li>
    <?php
        endwhile;
        // 重置查询全局变量，避免影响后续内容
        wp_reset_postdata();
    else :
        // 无文章时的提示内容
        echo '<li>No general documents found.</li>';
    endif;
    ?>
</ul>

关键提示 #

• 务必替换taxonomy的值为你创建自定义分类时的分类法slug（不确定的话，可以在后台分类编辑页面的URL里查看，比如edit-tags.php?taxonomy=document_categories中的document_categories就是分类法标识）。
• wp_reset_postdata()必须在循环结束后调用，用来重置当前文章的全局变量，防止和页面其他循环冲突。
• post_status => 'publish'确保只展示已发布的公开内容，避免草稿或私密文章被意外显示。

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