WordPress单标签模板失效：自定义FAQ分类法模板不生效

你遇到的核心问题是自定义分类法的slug和自定义文章类型的slug完全相同（都是faq），这会打乱WordPress的重写规则逻辑，导致系统无法正确识别分类归档请求，最终只能 fallback 到index.php。下面是具体的解决步骤：

1. 修改自定义分类法的重写slug，避免冲突 #

首先给自定义分类法设置一个和自定义文章类型不同的slug，比如改成faq-category。修改你的注册代码中$args里的rewrite参数：

$args = array(
    'hierarchical' => false,
    'labels' => $labels,
    'show_ui' => true,
    'show_admin_column' => true,
    'update_count_callback' => '_update_post_term_count',
    'query_var' => true,
    'has_archive' => true,
    // 修改slug，避免和自定义文章类型的slug冲突
    'rewrite' => array( 'slug' => 'faq-category' ),
);
register_taxonomy( 'faq', $post_type, $args );

2. 更新WordPress重写规则 #

修改代码后必须刷新重写规则，否则新slug不会生效：

• 登录WordPress后台，进入「设置」→「固定链接」
• 不需要修改任何设置，直接点击「保存更改」按钮，WordPress会自动重新生成重写规则

3. 使用正确的模板文件名 #

你之前尝试的taxonomy-{taxonomy}-{tag}.php命名不符合WordPress的模板规则，正确的分类归档模板命名逻辑是：

• 通用FAQ分类归档模板：taxonomy-faq.php（所有FAQ分类都会优先使用这个模板）
• 特定FAQ分类的专属模板：taxonomy-faq-{term-slug}.php（把{term-slug}替换成你实际创建的分类项的slug，比如分类slug是payment，就命名为taxonomy-faq-payment.php）

4. 确认自定义文章类型已正确关联分类法 #

最后检查你注册faq自定义文章类型的代码，确保在register_post_type的参数中，taxonomies字段包含了你的自定义分类法faq，示例代码如下：

register_post_type( 'faq', array(
    // 其他自定义文章类型参数...
    'taxonomies' => array( 'faq' ), // 确保关联了目标自定义分类法
    // 其他自定义文章类型参数...
) );

完成以上步骤后，点击归档页的FAQ分类标签，WordPress就能正确加载对应的分类归档模板，显示该分类下的所有FAQ文章了。

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