如何为自定义文章类型创建模板并获取ACF字段数据？

核心问题分析 #

你的single-{}.php模板中have_posts()返回false，本质是主查询未加载当前点击的自定义文章，而手动WP_Query能获取数据但只是查询该类型的所有文章，并非当前点击的单篇内容。

分步解决方案 #

1. 确认模板文件名完全正确 #

自定义文章类型的Single模板必须严格遵循命名规则：single-{自定义文章类型slug}.php

• 比如你的自定义文章类型slug是product，模板文件名必须是single-product.php
• 可通过查看自定义文章类型注册代码中的'rewrite' => array('slug' => 'xxx')或'name'参数确认slug

2. 刷新固定链接重写规则 #

自定义文章类型的单页路由依赖WordPress重写规则，必须手动刷新：

• 进入WP后台 → 设置 → 固定链接
• 任意选择一种固定链接格式（比如「文章名」），点击「保存更改」即可刷新规则

3. 修复主查询（推荐方案） #

如果文件名正确但主查询仍无数据，在子主题functions.php中添加以下代码，确保自定义文章类型的单页主查询正常：

add_action('pre_get_posts', function($query) {
    // 替换成你的自定义文章类型slug
    $cpt_slug = 'your_custom_post_type';
    if (!is_admin() && $query->is_main_query() && is_singular($cpt_slug)) {
        $query->set('post_type', $cpt_slug);
    }
});

4. 直接获取当前文章（临时应急方案） #

如果主查询修复无效，可绕过主循环直接获取当前文章对象：

<?php
// 获取当前被查询的文章对象
$current_post = get_queried_object();

if ($current_post) :
    // 初始化文章数据，让the_title()、the_content()等函数正常工作
    setup_postdata($current_post);
?>
    <h1><?php the_title(); ?></h1>
    <div class="post-content">
        <?php the_content(); ?>
        <!-- 传入文章ID确保ACF获取当前文章的字段 -->
        <p><?php echo get_field('field_name', $current_post->ID); ?></p>
    </div>
<?php
    // 重置文章数据，避免影响后续查询
    wp_reset_postdata();
else :
    echo '<p>No post found.</p>';
endif;
?>

额外注意事项 #

• 检查自定义文章类型注册代码，确保'public' => true，否则单页无法正常访问
• 若使用ACF字段，确保字段已绑定到对应的自定义文章类型

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