WordPress 主题设计教程（总目录）

这个系列在讲什么

很多人学 WordPress 主题设计，学完还是不知道“我打开一个网址，WordPress 到底按什么顺序调了哪些文件、怎么拼成一个页面”。这个系列就奔着这件事去：把一个真实主题拆开，一层层讲清楚。

全系列 6 卷 62 篇，代码全部来自我自己的站在用的主题，每一篇都有“改前 / 改后”的真实对照。

卷一 · 骨架：一个页面是怎么拼出来的（8 篇）

1. 输入一个网址后，WordPress 在后台到底忙了什么
2. 建了 page.php 却对文章不生效？模板层级一次讲清（上）
3. 分类页、搜索页、404 各用哪个模板？模板层级（下）
4. 一个 WordPress 主题最少要几个文件？答案是两个
5. get_header() 不是函数调用，是“搬文件”
6. style.css 开头那段注释是主题的“身份证”
7. 拆开一个真实主题：从文件名读出“页面地图”
8. 复盘：一个 WordPress 页面到底是怎么拼出来的

卷二 · 循环：主题的心脏（10 篇）

1. 主循环：have_posts() 和 the_post() 到底在干什么
2. the_title / the_content 的数据从哪来
3. 为什么“在循环外调模板标签”会出事
4. 一个页面跑两次循环：rewind_posts 与多循环
5. query_posts 为什么是坏东西
6. WP_Query：自己查文章的正确姿势
7. WP_Query 常用参数速查
8. pre_get_posts：想改主查询，该走这个门
9. WP_Query 与分页：max_num_pages、paged 怎么用
10. 什么时候必须 wp_reset_postdata()

卷三 · 零件：主题的各个部件（12 篇）

1. head 与 wp_head：主题最容易漏的一环
2. 手写 head 的代价：title/description 该谁管
3. 导航菜单（上）：register_nav_menu 与 wp_nav_menu
4. 导航菜单（下）：当前项高亮与多级菜单
5. 侧栏与小工具（上）：register_sidebar 与 dynamic_sidebar
6. 侧栏与小工具（下）：before_widget 与 before_title
7. 搜索表单：get_search_form 与 searchform.php
8. 评论区：comments_template 与评论模板
9. 分页（上）：从自造函数到标准写法
10. 分页（下）：数字分页与“空 li”的坑
11. 面包屑：一个 div 套 ol 的故事
12. 文章内的零件：分类、标签、作者、日期怎么输出

卷四 · 功能：functions.php 与钩子（10 篇）

1. functions.php 是什么、什么时候加载
2. 钩子入门：add_action 和 add_filter 到底在干什么
3. 优先级与 remove_action 为什么删不掉
4. 主题功能 vs 插件功能：界线在哪
5. add_theme_support：主题的能力声明
6. 图片尺寸：add_image_size 与缩略图
7. 摘要：the_excerpt 与自定义摘要函数
8. 评论过滤：preprocess_comment 防垃圾实战
9. 安全基础：esc_html / esc_attr / esc_url
10. 主题体检：一份常见错误清单

卷五 · 实战：从零写一个主题（12 篇）

1. 开始之前：定一个“最小可用”的主题
2. 搭骨架：style.css + header + footer + index
3. 首页：文章列表与分页
4. 文章页：标题、正文、meta、相关文章
5. 分类页与标签页
6. 页面（page）与“关于”页
7. 搜索页与 404 页
8. 侧栏、搜索框、小工具
9. 导航菜单与移动端适配
10. 样式：继续用框架还是自己写
11. SEO 层：canonical / OG / JSON-LD
12. 收尾：测试、打包、上线

卷六 · 进阶：让主题更专业（10 篇）

1. 子主题：为什么不要直接改别人的主题
2. 主题性能：defer、合并、懒加载
3. 缓存与主题：对象缓存、页面缓存
4. 多语言：__() / _e() / .po / .mo
5. 区块主题（FSE）：theme.json 与块模板
6. 主题安全：XSS、CSRF、文件包含
7. 调试：WP_DEBUG 与 Query Monitor
8. 主题目录提交：官方审核到底卡什么
9. 从 caogenbj 到“自己的主题”：重构路线图
10. 系列总结：一张图看懂 WordPress 主题

怎么读

如果时间不多，先读这四篇，能搭起骨架：卷一第 1 篇（全景图）、卷二第 9 篇（主循环）、卷三第 19 篇（wp_head）、卷六第 62 篇（总结）。

其余按需查。卡住的时候回来搜一下，比顺序读完有用。

相关文章

• 系列总结：一张图看懂 WordPress 主题
• 从 caogenbj 到“自己的主题”：重构路线图
• 主题目录提交：官方审核到底卡什么
• 调试：WP_DEBUG 与 Query Monitor
• 主题安全：XSS、CSRF、文件包含
• 区块主题（FSE）：theme.json 与块模板
• 多语言：__() / _e() / .po / .mo
• 缓存与主题：对象缓存、页面缓存
• 主题性能：defer、合并、懒加载
• 子主题：为什么不要直接改别人的主题