看懂 WordPress 主题，先从文件分工开始。本文整理经典 PHP 主题里常见的模板文件，说明它们分别负责什么，以及找不到专用模板时会怎样回退。区块主题主要使用 HTML 区块模板，不能直接照搬这里的文件结构。
先记住模板的基本规则
经典主题通常以 style.css 和 index.php 为基础。style.css 需要包含让 WordPress 识别主题的信息头；index.php 是找不到更具体模板时的兜底模板。实际开发时，再按内容类型补充其他文件。子主题可以继承父主题的模板，不必把父主题文件全部复制一份。
常用主题文件
functions.php
主题的功能文件，用来组织前台、后台需要的函数，注册主题功能，并处理主题设置相关逻辑。它很常用，但不是主题必需文件；是否创建，取决于主题需要哪些功能。它也不是直接显示页面内容的模板。
index.php
经典主题的主模板，也是模板层级的最后回退。缺少更具体的模板时，WordPress 会使用它来显示请求的内容，所以它并不只负责普通文章列表。基础主题可以先用它组织页面，再逐步拆出文章、页面和归档等专用模板。
header.php
头部模板片段，通常放横幅、导航栏、用户头像或发布入口等公共内容。写好后可以在不同页面模板中重复调用，不用每个页面都写一遍。
footer.php
底部模板片段，常见内容包括版权信息、底部快捷导航等。和头部模板一样，可以在多个页面中复用。
sidebar.php
侧边栏模板片段。很多博客把侧栏放在右侧，也可以放在左侧或其他区域，具体位置取决于主题布局，并不是所有 WordPress 页面都固定有右侧栏。
style.css
主题的主样式表，同时包含主题名称等信息头。CSS 可以写在这个文件里，也可以拆到其他样式文件中，再由主题正确加载。即使把实际样式拆出去了，用于识别主题的信息头仍然需要保留。
comments.php
经典主题的评论模板，负责评论区域的输出。需要调整评论列表、评论表单或相关展示时，可以从这个文件入手；具体功能也可能涉及主题的其他代码。
front-page.php
站点首页模板。只要主题里存在这个文件，访问站点首页时就会优先使用它，无论后台“设置 → 阅读 → 您的主页显示”选择的是最新文章，还是静态页面。
home.php
文章索引页模板，用来显示博客文章列表。首页设置为“最新文章”且没有 front-page.php 时，会用到它；如果首页使用静态页面，它对应的是另行指定的“文章页”，而不是那个静态首页。找不到 home.php 时，文章列表会回退到 index.php。
tag.php
标签归档模板，用来显示某个标签下的文章列表。它并不是把全站所有标签都自动列出来的标签总览页。
single.php
单篇文章模板，负责普通文章详情页。读者打开一篇文章时，看到的正文区域、文章信息以及相关布局，通常由这一类模板组织。
single-{post-type}.php
指定文章类型的单篇详情模板。把 {post-type} 替换成对应文章类型的名称，就能为该类型安排专用模板。
archive-{post-type}.php
指定文章类型的归档模板，用于该类型的内容列表。把 {post-type} 换成对应类型名称即可；该文章类型需要启用相应归档功能。
page.php
后台“页面”内容的默认模板。页面和“文章”是不同的内容类型，常用于关于、联系等相对独立的内容，也可以搭配专用模板实现不同的页面结构。
page-{slug}.php
指定页面别名的模板。把 {slug} 替换为目标页面的实际别名，就可以为这个页面单独定义模板。更改文件名只是改变匹配目标，不会自动创建一个新页面。
singular.php
单条内容的通用回退模板。当没有匹配到更具体的文章模板或 single.php，以及没有匹配到更具体的页面模板或 page.php 时，可以继续回退到它；如果它也不存在，最终使用 index.php。
search.php
站内搜索结果模板。读者在网站搜索文章后，跳转到的搜索结果页通常由它负责。
404.php
未找到内容时的模板。请求的文章、页面或其他内容不存在时，可以用它显示 404 提示和返回入口。
category.php
分类归档模板，用来显示某个分类下的文章。它和标签归档的用途相近，只是筛选依据换成了分类。
author.php
作者归档模板，用来展示某位作者的文章列表。可以把它理解为按作者整理的文章历史页。iro 主题曾被用作类似展示的参考，具体页面结构仍需结合实际主题版本查看。
怎样继续查
这是一份常用文件速查，并没有列出 WordPress 的所有模板。遇到同一页面存在多个候选文件时，关键是继续查模板层级，而不是只看文件名猜用途。
可以在 Bing 等搜索引擎中搜索“WordPress 主题开发手册”，也可以直接查看 WordPress 官方的 模板文件说明、模板层级和 主题功能文件说明。先分清文件职责，再对照实际主题目录去看，会更容易理解。
暂无评论内容