求助：如何为自定义文章类型创建单页模板？模板未生效

咱们一步步排查问题，先从WordPress的核心规则入手，帮你搞定这个模板不生效的问题：

第一步：确认模板文件名是否符合规则 #

WordPress对自定义文章类型（CPT）的单页模板有严格的命名要求：必须是single-{你的CPT别名}.php。你现在用的是single-cpt_archive_post.php，首先得核对你注册CPT时的slug（别名）是否完全匹配：
打开主题的functions.php，找到注册CPT的register_post_type()代码，重点看这部分：

// 示例注册代码，注意第一个参数或rewrite里的slug
register_post_type( 'cpt_archive_post', array(
    'public' => true,
    'rewrite' => array( 'slug' => 'cpt-archive-post' ), // 这里的slug是模板命名的关键
    // 其他参数...
) );

如果rewrite里设置的slug是cpt-archive-post，那模板文件名就得改成single-cpt-archive-post.php；如果没设置rewrite，默认slug就是注册时的第一个参数（cpt_archive_post），那你的模板名是对的，继续往下排查。

第二步：刷新固定链接规则 #

WordPress会缓存固定链接规则，哪怕模板名正确，没刷新也可能不生效：

• 登录WP后台，进入「设置」→「固定链接」
• 不用修改任何选项，直接点击「保存更改」，让系统重新生成链接规则。

第三步：检查模板文件的位置与权限 #

• 确保single-{slug}.php放在当前激活主题的根目录下，不是子文件夹里
• 检查文件权限：一般设置为644（文件）/755（文件夹），避免服务器无法读取文件

第四步：强制指定模板（备用方案） #

如果上面的方法都没用，你可以在functions.php里加代码强制绑定模板：

add_filter( 'single_template', 'custom_cpt_single_template' );
function custom_cpt_single_template( $template ) {
    global $post;
    // 替换成你的CPT别名
    if ( 'cpt_archive_post' === $post->post_type ) {
        $custom_template = get_template_directory() . '/single-cpt_archive_post.php';
        if ( file_exists( $custom_template ) ) {
            return $custom_template;
        }
    }
    return $template;
}

添加后记得再次刷新固定链接。

第五步：排查冲突问题 #

• 暂时切换到WordPress默认主题（比如Twenty Twenty-Four），测试模板是否生效，排除当前主题的问题
• 暂时禁用所有插件，排查是否有插件干扰了模板层级的判断

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