模板层级是 WordPress 主题开发的基础知识,但真正掌握它的实战应用,需要理解不同场景下的文件命名策略。

分类归档的精确控制

访问一个分类归档页时,WordPress 按以下顺序查找模板:category-{slug}.php 匹配分类别名、category-{id}.php 匹配分类 ID、category.php 通用分类模板、archive.php 通用归档模板、index.php。如果你想让新闻分类使用特殊布局,创建 category-news.php 即可,其他分类仍然使用 category.php 或 archive.php。

独立页面的精确控制

对于独立页面,查找顺序是:page-{slug}.php、page-{id}.php、page.php、singular.php、index.php。如果你为关于我们页面创建了 page-about.php,该页面会自动使用这个模板,不需要在后台做任何选择。

自定义文章类型的归档控制

对于文章类型 product,查找顺序是:archive-product.php、archive.php、index.php。如果产品有自定义分类法 product_category,分类归档的查找顺序是:taxonomy-product_category-{term}.php、taxonomy-product_category.php、archive.php、index.php。

前端首页与博客页的区分

front-page.php 优先级最高,覆盖静态首页设置。home.php 用于博客文章列表页,当首页设置为静态页面时。如果只使用 index.php,首页和博客页会共用同一个模板。

最佳实践

始终包含 index.php 作为最终回退。只在需要特殊布局时才创建更具体的模板文件,不要为每个页面都创建独立模板。保持模板文件命名与 slug 一致,便于维护。