主题体检：一份常见错误清单
一份可以直接用的清单
卷四讲完了。这一篇不再讲新东西，给一份“主题体检清单”——拿着它，一条条对照自己的主题，能查出大部分常见毛病。
一、head 部分
| 检查项 | 怎么查 |
|---|---|
有没有 wp_head() |
head 里搜 wp_head |
有没有 wp_footer() |
footer 里搜 |
| title 是不是只有 1 个 | 源码搜 <title |
| description 是不是只有 1 个 | 源码搜 name="description" |
有没有 lang 属性 |
看 <html> 标签 |
| 有没有 BOM | 用编辑器看编码，或看源码最前面有没有空白 |
二、循环部分
| 检查项 | 怎么查 |
|---|---|
一个模板里有几个 while ( have_posts() ) |
超过 1 个就要警惕 |
| 模板标签是不是都在循环里 | the_title 等出现在循环外 = 有问题 |
有没有 query_posts |
搜一下，有就改成 WP_Query |
new WP_Query 后有没有 wp_reset_postdata |
成对出现 |
三、模板完整性
| 文件 | 有没有 |
|---|---|
index.php |
必须有 |
single.php |
文章页 |
page.php |
独立页面 |
category.php |
分类页 |
search.php |
搜索结果页（常常缺） |
404.php |
404 页（常常缺） |
header.php / footer.php |
页头页脚 |
functions.php |
功能层 |
四、重复代码
| 检查项 | 怎么查 |
|---|---|
| 有没有模板手抄了 footer | 搜版权文字，看出现在几个文件 |
有没有多个 <ul class="pagination"> |
分页函数内部和模板各一个 = 嵌套 |
| 有没有重复的 head 代码 | 比如两个 <meta charset> |
五、HTML 合法性
| 检查项 | 说明 |
|---|---|
<ol> / <ul> 里只有 <li> |
塞 div 是非法嵌套 |
没有空的 <li></li> |
分页常见 |
没有空的 class= |
属性写了一半 |
| 标签都闭合 | 用 W3C 校验器跑一遍 |
六、安全与性能
| 检查项 | 说明 |
|---|---|
| 输出纯文本有没有转义 | esc_html / esc_attr |
链接有没有 esc_url |
href / src |
外链有没有 noopener |
target="_blank" 时 |
图片有没有 loading="lazy" |
首屏外的图 |
| 有没有用原图当缩略图 | 3000px 的图显示 300px |
caogenbj 的体检结果
拿这份清单扫一遍，它当时的问题：
- head：没有 wp_head（致命）、title 和 description 各 1 个（对）、没有 lang（错）、有 BOM（错）；
- 循环：single.php 有两个 while（错）、query_posts（错）；
- 完整性：缺 search.php / 404.php / tag.php / archive.php；
- 重复代码：single.php 和 page.php 手抄了 footer；
- HTML：分页双重 ul、面包屑 ol 套 div；
- 安全：description 裸输出没转义。
这些就是前面几卷讲的那些问题。一张清单，全查出来了。
怎么用这份清单
建议顺序：
- 先查“head 部分”和“模板完整性”——这两块影响最大；
- 再查“循环”和“重复代码”——这两块最容易藏 bug；
- 最后查“HTML 合法性”和“安全性能”——锦上添花。
别一次全改，改一块测一块。主题文件改错了会白屏，得一步一步来。
小结
一句话记住：体检顺序 = head → 模板完整性 → 循环 → 重复代码 → HTML → 安全；改一块测一块。
卷四到这里结束。你已经掌握了 functions.php、钩子、主题支持、摘要、评论过滤、转义。
卷五开始“从零写一个主题”——把前面所有知识，落成一个能上线的主题。
本系列导航
相关文章
搜索文章：
联系方式：
近期文章