WordPress自定义主题开发：single模板层级及URL异常问题咨询

一、修复URL结构（实现www.car.com/BMW/M4） #

你手动写的链接/BMW/M4不符合WordPress默认URL规则，文章默认不会嵌套在页面路径下，因此点击后会被重写为/M4。要实现目标URL，可按以下方式处理：

1. 方法一：将文章转为页面（简单直接） #

如果M4不需要文章的特定功能，直接把它改为页面，在页面编辑界面的「页面属性」里，将「父页面」选择为BMW。WordPress会自动生成/BMW/M4的URL，后续用get_permalink($page_id)获取正确链接即可，无需手动写死路径。

2. 方法二：用自定义帖子类型（CPT）实现嵌套URL #

如果必须保留M4为文章类内容，需注册自定义帖子类型并配置重写规则：

• 在主题的functions.php中添加以下代码（假设自定义帖子类型为car）：

function register_car_post_type() {
    $args = array(
        'public' => true,
        'label'  => 'Cars',
        'rewrite' => array(
            'slug' => 'BMW/%car%', // 指定父级页面slug
            'with_front' => false
        ),
        'query_var' => true,
    );
    register_post_type( 'car', $args );
}
add_action( 'init', 'register_car_post_type' );

// 替换重写标签，确保URL正确解析
function rewrite_car_permalink( $post_link, $post ) {
    if ( 'car' === $post->post_type ) {
        return str_replace( '%car%', $post->post_name, $post_link );
    }
    return $post_link;
}
add_filter( 'post_type_link', 'rewrite_car_permalink', 10, 2 );

• 代码添加后，进入WordPress后台「设置→固定链接」，点击「保存更改」刷新重写规则。
• 之后创建的car类型帖子M4，URL会自动变为/BMW/M4，用get_permalink($post_id)获取链接即可。

二、修复模板层级不生效问题 #

你创建的single-{post_type}-{slug}.php未被调用，反而使用index.php，大概率是以下原因：

1. 检查模板文件命名 #

• 确认帖子类型slug：如果是默认文章类型，帖子类型为post，文件名应为single-post-m4.php；如果是自定义帖子类型（如上述car），则文件名是single-car-m4.php。
• 注意大小写：服务器系统可能对文件名大小写敏感，需确保文件名中的{slug}和后台帖子的slug完全一致（比如后台slug是m4，文件名就不能写M4）。

2. 刷新重写规则 #

修改模板或注册CPT后，必须进入「设置→固定链接」点击「保存更改」，让WordPress重新识别模板层级和URL规则。

3. 确认帖子实际slug #

进入M4的编辑界面，查看「permalink」区域显示的实际slug，确保和模板文件名中的{slug}完全匹配。

4. 调试模板层级（可选） #

若仍不生效，可在主题functions.php中添加代码查看当前加载的模板：

add_action( 'wp_footer', 'debug_current_template' );
function debug_current_template() {
    global $template;
    echo '当前加载模板：' . basename($template);
}

访问目标页面后，查看底部输出的模板文件名，即可明确WordPress实际调用的文件，再针对性调整。

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