本文是《WordPress主题开发从入门到精通》系列教程的第三篇。我们将揭秘WordPress的“智能大脑”——模板层级（Template Hierarchy），理解它如何自动为首页、文章页、分类页等选择最合适的模板文件。
在开始之前，我先问你一个问题。你有没有想过，当你访问网站的首页时，WordPress用的是index.php模板；当你点进一篇文章时，显示效果和首页完全不同，它又是用的哪个模板呢？
这就是模板层级在背后默默工作的结果。
模板层级是什么？一个聪明的“匹配游戏”
想象一下，WordPress主题系统就像一个聪明的秘书。当有访客来到你的网站（比如访问了一篇文章），这位秘书会收到一个指令：“现在需要展示一篇文章的具体内容”。
这位秘书不会随便拿个模板来用，它会按照一个设定好的优先级列表，去你的主题文件夹里寻找最匹配的模板文件。
这个“优先级列表”和“寻找过程”，就是模板层级。
它的工作原则是：用最专用的，没有专用的就用通用的。
一个具体的例子：文章页面的模板寻找过程
假设你的网站上有一篇文章，它的分类是“技术笔记”，这篇文章的ID是123。那么当用户访问这篇文章时，WordPress会按照下面的顺序在你的主题文件夹里寻找模板：
single-post-技术笔记.php- (专用模板：文章分类为“技术笔记”)single-post-123.php- (专用模板：文章ID为123)single-post.php- (通用文章模板)single.php- (所有文章页的通用模板)singular.php- (所有单页型内容——文章和页面的通用模板)index.php- (最终回退，万能模板)
看到了吗？WordPress会从最具体的模板开始找起（比如直接用分类名或文章ID命名的模板），如果没找到，就退一步，用更通用的模板，直到找到可用的为止。index.php是最后的保障，只要你的主题里有它，任何页面就都能正常显示。
最重要的模板层级路径图解
文字描述可能有点抽象，下面这个流程图清晰地展示了不同页面类型的匹配顺序。这张图是理解模板层级的核心，建议你仔细看看：
flowchart TD
A[访问网站] --> B{判断页面类型}
B -->|首页| C1[front-page.php]
C1 --> C2[home.php]
C2 --> C3[index.php]
B -->|文章页| D1[single-post-{slug/id}.php]
D1 --> D2[single-post.php]
D2 --> D3[single.php]
D3 --> D4[singular.php]
D4 --> C3
B -->|页面| E1[page-{slug/id}.php]
E1 --> E2[page-{page-template}.php]
E2 --> E3[page.php]
E3 --> E4[singular.php]
E4 --> C3
B -->|分类页| F1[category-{slug}.php]
F1 --> F2[category-{id}.php]
F2 --> F3[category.php]
F3 --> F4[archive.php]
F4 --> C3
F4 --> G1[tag-{slug}.php]
G1 --> G2[tag.php]
G2 --> F4[archive.php]
C3[index.php<br>最终回退]动手实践：创建不同的模板文件
光说不练假把式。现在让我们在之前的主题基础上，创建几个新模板，亲眼看看模板层级的效果。
第一步：创建文章页专用模板 single.php
在主题文件夹里新建一个文件，命名为 single.php。这个模板将专门用于显示单篇文章。
<?php get_header(); ?>
<main class="main-content single-post-content">
<?php if ( have_posts() ) : ?>
<?php while ( have_posts() ) : the_post(); ?>
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<!-- 文章标题 -->
<header class="article-header">
<h1><?php the_title(); ?></h1>
<div class="post-meta">
<span>作者：<?php the_author(); ?></span> |
<span>发布时间：<?php the_time('Y年m月d日'); ?></span> |
<span>分类：<?php the_category('，'); ?></span>
</div>
</header>
<!-- 文章特色图片 -->
<?php if ( has_post_thumbnail() ) : ?>
<div class="post-thumbnail">
<?php the_post_thumbnail('large'); ?>
</div>
<?php endif; ?>
<!-- 文章内容 -->
<div class="entry-content">
<?php the_content(); ?>
</div>
<!-- 文章标签 -->
<footer class="article-footer">
<?php the_tags('<div class="post-tags">标签：', '，', '</div>'); ?>
</footer>
</article>
<!-- 上一篇/下一篇文章导航 -->
<nav class="post-navigation">
<div class="nav-previous"><?php previous_post_link('« %link'); ?></div>
<div class="nav-next"><?php next_post_link('%link »'); ?></div>
</nav>
<?php endwhile; ?>
<?php endif; ?>
</main>
<?php get_footer(); ?>第二步：创建页面模板 page.php
再创建一个 page.php，这个模板将用于显示“页面”（比如关于我们、联系方式）。
<?php get_header(); ?>
<main class="main-content page-content">
<?php if ( have_posts() ) : ?>
<?php while ( have_posts() ) : the_post(); ?>
<article id="page-<?php the_ID(); ?>" <?php post_class('page'); ?>>
<header class="page-header">
<h1><?php the_title(); ?></h1>
</header>
<div class="page-content">
<?php the_content(); ?>
</div>
</article>
<?php endwhile; ?>
<?php endif; ?>
</main>
<?php get_footer(); ?>你可能注意到了，这两个新模板的开头和结尾用了 get_header() 和 get_footer()，但我们还没有创建这两个文件。现在就来创建它们，这是优化主题结构的重要一步。
第三步：创建共享的页头 header.php 和页脚 footer.php
创建 header.php：
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
<meta charset="<?php bloginfo('charset'); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>
<?php
if (is_front_page() || is_home()) {
bloginfo('name');
} else {
echo wp_title('') . ' | ' . get_bloginfo('name');
}
?>
</title>
<link rel="stylesheet" href="<?php echo get_stylesheet_uri(); ?>">
<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<header class="site-header">
<h1 class="site-title">
<a href="<?php echo esc_url(home_url('/')); ?>">
<?php bloginfo('name'); ?>
</a>
</h1>
<p class="site-description"><?php bloginfo('description'); ?></p>
</header>创建 footer.php：
<footer class="site-footer">
<p>© <?php echo date('Y'); ?> <?php bloginfo('name'); ?>. 保留所有权利。</p>
<p>Powered by <a href="https://wordpress.org">WordPress</a></p>
</footer>
<?php wp_footer(); ?>
</body>
</html>第四步：更新 index.php，使用新的页头页脚
现在，我们可以把 index.php 简化很多：
<?php get_header(); ?>
<main class="main-content">
<?php if ( have_posts() ) : ?>
<?php while ( have_posts() ) : the_post(); ?>
<article class="article-item">
<h2 class="article-title">
<a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
</h2>
<div class="article-meta">
发布于：<?php the_time('Y-m-d'); ?>
</div>
<div class="article-excerpt">
<?php the_excerpt(); ?>
</div>
</article>
<?php endwhile; ?>
<?php else : ?>
<p>还没有发布任何文章。</p>
<?php endif; ?>
</main>
<?php get_footer(); ?>测试你的模板层级
现在，你的主题结构应该看起来像这样：
/my-first-theme/
├── header.php # 新增：共享页头
├── footer.php # 新增：共享页脚
├── index.php # 修改过的：主模板
├── single.php # 新增：文章页模板
├── page.php # 新增：页面模板
└── style.css去你的网站进行测试吧！
- 访问首页：仍然使用
index.php - 点击一篇文章：现在会使用专用的
single.php模板，显示效果和首页不同 - 访问一个页面（比如关于我们）：会使用
page.php模板
你会发现，不同的页面类型自动匹配了不同的模板，网站看起来更专业了！
总结：为什么模板层级如此重要？
通过学习模板层级，你应该掌握以下几点：
- 智能化设计：WordPress会自动为不同的内容选择最合适的模板，无需手动指定。
- 可定制性极强：你可以为某个特定的分类、甚至某篇特定的文章创建独一无二的模板。
- 结构清晰：将不同功能的代码分离到不同的模板文件中，让主题更易于维护。
index.php是基石：它是所有模板的最终回退，确保网站无论如何都能正常显示。
现在，你的主题已经具备了基本但完整的结构。在下一篇文章中，我们将学习如何为主题添加导航菜单功能，让用户可以在不同页面间轻松跳转。
评论框