WordPress 默认模板文件名清单,全部是系统自带、自动识别、不用设置的,一看就懂!
按加载优先级排序
| 页面场景 | 优先模板文件名 | 说明 |
|---|---|---|
| 全站最终兜底 | index.php | 所有页面找不到模板时都会用它 |
| 404 错误页 | 404.php | 页面不存在时自动加载 |
| 搜索结果页 | search.php | 搜索列表专用 |
| 通用列表页 | archive.php | 文章、分类、标签、自定义分类通用 |
| 博客首页列表 | home.php | 博客文章列表页(比 page-home 优先) |
| 单页面(默认) | page.php | 所有「页面」默认模板 |
| 指定别名页面 | page-{slug}.php | 按页面别名匹配,如 page-about.php |
| 文章详情页 | single.php | 普通文章详情默认模板 |
| 文章分类列表 | category.php | 文章分类列表页 |
| 文章标签列表 | tag.php | 文章标签列表页 |
| 作者列表页 | author.php | 某作者发布的文章列表 |
| 日期归档页 | date.php | 按年 / 月 / 日归档的文章列表 |
| 产品商店首页 | archive-product.php | WooCommerce 商店 / 产品列表页 |
| 产品详情页 | single-product.php | 单个商品详情页 |
| 产品分类列表 | taxonomy-product_cat.php | 产品二级 / 三级分类页(你现在用) |
| 产品标签列表 | taxonomy-product_tag.php | 产品标签页 |
| 用途 | 模板文件名 |
|---|---|
| 产品页面(Products) | archive-product.php |
| 产品二 / 三级分类 | taxonomy-product_cat.php |
| 通用列表兜底 | archive.php |
| 单页默认 | page.php |
| 文章详情 | single.php |
| 全站兜底 | index.php |
WordPress 核心默认模板文件
1. 全局通用
index.php
→ 终极兜底,所有页面找不到模板时,最后用它
404.php
→ 404 错误页面
search.php
→ 搜索结果页
archive.php
→ 通用列表页(文章、分类、标签、产品都会优先用它)
2. 页面 page 相关
page.php
→ 所有单页面默认模板
page-xxx.php
→ 指定页面 ID / 别名专用
home.php
→ 首页(博客列表)
3. 文章 post 相关
single.php
→ 文章详情页
category.php
→ 文章分类列表页
tag.php
→ 文章标签页
author.php
→ 作者页
date.php
→ 按日期归档页
4. WooCommerce 产品专用
archive-product.php
→ 产品列表页(商店页)
single-product.php
→ 产品详情页
taxonomy-product_cat.php
→ 产品分类页(二级 / 三级分类)
taxonomy-product_tag.php
→ 产品标签页
最关键的 5 个
archive.php 通用列表
page.php 页面
single.php 文章详情
archive-product.php 产品列表
taxonomy-product_cat.php 产品分类(二级/三级)
当你访问 二级 / 三级产品分类时
WordPress 自动按顺序找:
taxonomy-product_cat.php
archive-product.php
archive.php
index.php
当你访问 自定义页面(Products)
archive-product.php(指定的模板)
page.php
index.php
核心三个页面:
页面 → page.php / archive-product.php
文章 / 产品列表 → archive.php
二级 / 三级分类 → taxonomy-product_cat.php