学习路线
按上线、配置、内容、用户、商城、论坛、优化和二次开发顺序阅读子比主题开发文档。
子比主题功能很多，不适合从某个单点功能开始随机阅读。更稳的方式是先完成“网站能访问、主题能运行、基础功能可用”，再按网站类型补齐内容、用户、商城、论坛和二次开发能力。
这页不是官网文章列表的搬运，而是把官网阅读指引映射到本站已经沉淀的开发文档：每一步都对应可继续深入的文档页。
准备阶段
上线前先准备域名、服务器、WordPress、子比主题文件、邮箱或短信服务。准备开启付费、商城、会员、余额和积分时，还要提前准备支付资料。
如果还没有服务器环境，先看 在线部署。如果已经有环境但域名打不开，先看 域名解析与站点访问 和 伪静态、缓存与 CDN。
第一阶段：让网站跑起来
先解决运行环境、域名、固定链接和主题安装。这个阶段不要急着调商城、论坛或复杂模块。
在线部署
选择宝塔、Docker 或 LNMP 方式安装 WordPress 运行环境。
域名解析与站点访问
配置 A/CNAME、主域名与 www、Cloudflare、HTTPS 和站点绑定。
环境检查
检查 PHP 扩展、目录权限、数据库、HTTPS、缓存和日志。
伪静态、缓存与 CDN
处理固定链接、用户中心 404、Ajax、支付回调和缓存排除。
更新与维护
处理主题更新、授权域名、备份、样式错乱和回滚。
这个阶段的完成标准：主域名和 www 都能访问，WordPress 后台能登录，文章页不是 404，PHP 扩展和目录权限没有明显错误，开启 HTTPS 后没有循环跳转。
第二阶段：完成基础外观和导航
网站能跑起来后，再配置 Logo、主题色、背景、导航、菜单、文章列表和基础 SEO。
主题常用设置
按配置域理解 Logo、SEO、懒加载、搜索、邮件、自定义代码和主题视觉。
站点框架与导航
扩展页头、顶部导航、移动菜单、右侧浮动按钮和手机底部 Tabbar。
菜单徽章与高级子菜单
拆解菜单项图标、徽章、高级子菜单、图文卡片和多栏目链接。
主题样式、背景与模式切换
梳理主题色、背景图、布局宽度、导航页脚颜色和日夜间模式。
SEO Head 与 robots
梳理 title、keywords、description、canonical、noindex 和 head 清理。
建议先按后台配置完成一次，再回到源码文档理解配置字段如何落地到前台。这样以后改样式、加菜单或做子主题覆盖时，不会绕过主题自己的配置系统。
第三阶段：搭建页面、模块和首页
当基础外观稳定后，再处理首页、页面布局、模块、小工具、广告位、友情链接和内容列表。
顶部多功能组件与广告位
蒸馏顶部幻灯片、视频背景、搜索叠加、图标卡片和广告位。
主题小工具与侧栏
扩展小工具注册、页面容器、侧栏位置、显示规则和 Ajax 小工具加载。
普通页面与前台设置
扩展普通页面模板、页面头部样式、页面专属小工具和前台设置弹窗。
首页与归档列表
扩展首页 Tab、分类/标签/专题封面、筛选菜单、排序查询和 Ajax 分页。
外链重定向与网址导航
扩展 go.php 外链中转、网址导航、用户网址和友情链接模块。
这个阶段的重点是先复用主题已有模块能力。只有当现有 Hook、短代码、小工具和页面设置都满足不了需求时，再考虑模板覆盖。
第四阶段：掌握文章、媒体和编辑器
内容站、资源站、教程站都应该先把文章发布、正文模块、图片、视频、目录树和投稿链路跑通。
文章正文与单页渲染
扩展文章页框架、顶部封面、正文 Hook、目录、高度限制和版权。
古腾堡块与正文模块
梳理编辑器区块、短代码桥接、正文保存结构和前台渲染依赖。
媒体上传
说明前台上传、分片上传、媒体库隔离、附件归属和特色媒体编辑。
图片灯箱与媒体
整理图片灯箱、懒加载、媒体输出和 CDN 图片异常排查。
视频资源与播放器
梳理视频封面、DPlayer、剧集切换、iframe 嵌入和付费视频链路。
前台投稿与编辑
梳理投稿页、草稿、审核、付费内容、特色封面和删除文章。
如果要新增正文能力，优先判断它属于古腾堡块、短代码、文章 meta、模板 Hook 还是前台投稿字段。不同入口的数据保存和渲染方式完全不同。
第五阶段：配置账户、用户和互动
登录注册、验证码、找回密码、绑定邮箱手机、第三方登录、用户资料、签到、等级、消息和评论互动会互相影响。建议先配置邮件，再配置登录注册。
账户与验证码
配置 SMTP、登录注册、找回密码、绑定邮箱手机和人机验证。
用户系统
扩展登录、注册、资料、绑定、签到、等级、认证和用户中心。
作者主页与用户中心
扩展作者主页 Tab、用户中心抽屉 Tab、账户安全和当前用户 Ajax 数据。
用户成长与权限体系
扩展签到、等级经验、认证、徽章、邀请码、用户能力和禁封申诉。
评论与互动
梳理评论提交、审核、置顶、点赞、收藏、关注、举报和消息联动。
消息通知
扩展站内消息、私信、微信模板消息和业务通知。
这个阶段最容易出问题的是缓存。登录态、验证码、用户中心、消息数、Ajax 响应都不能被当成普通静态页面缓存。
第六阶段：按业务选择商城、付费和资产
不是每个站点都需要商城。博客和资讯站可以先跳过这一阶段；资源下载、会员资源站、知识付费和实物商品站再继续。
商城模块
扩展 shop_product、购物车、商品页、售后、物流和店铺能力。
商城商品发布字段
梳理规格选项、库存、发货类型、售后继承、前台 Vue 数据和保存边界。
商城购物车与确认下单
梳理购物车数据、确认弹窗、服务端重算、Zibpay 创建和支付发起链路。
商城发货、售后与优惠
梳理订单付款后的发货、物流、售后状态机、退款、商品优惠和优惠码。
Zibpay 扩展
扩展订单、支付、下载权限、余额、积分、VIP、分佣和提现。
用户资产、积分与余额
梳理积分、余额、转账、充值、购买积分、免费积分发放和后台调整。
支付、订单和资产不要直接改数据库字段。扩展时先找 Zibpay 订单创建、支付回调、权限判断、下载校验、余额积分变更和消息通知的现有入口。
第七阶段：需要社区时再配置论坛
论坛、圈子、板块权限、发帖限制、阅读限制、帖子排序和版主体系适合社区型站点。普通内容站可以晚一点再读。
论坛模块
扩展 plate、forum_post、话题、标签、版主和帖子流程。
论坛排序与推荐指数
拆解帖子排序选项、推荐分计算、动态时间权重和评分联动。
论坛小工具与侧栏
整理论坛侧栏注册、版块小工具、帖子列表、话题列表和 Ajax 加载。
前台投稿与编辑
论坛发帖、投稿、草稿、审核、特色媒体和删除内容的入口。
论坛功能和用户权限、消息通知、积分等级、内容审核都有交叉。新增论坛扩展时，先确认当前站点是否开启论坛模块，再判断帖子、板块、话题和普通文章的差异。
第八阶段：上线后优化和扩展
网站进入运营阶段后，再处理搜索、翻译、内容审核、分享、微信、百度提交、自定义开发和部署维护。
搜索体系
梳理搜索页、搜索弹窗、类型 Tab、筛选、排序、关键词、搜索历史和 Meilisearch。
多语言智能翻译与 JS 国际化
梳理前后台语言分离、前台智能翻译、术语配置和动态内容监听。
内容审核与发布安全
梳理 API 内容审核、投稿评论私信审核、图片审核、论坛审核和人工审核。
分享、海报与微信分享
扩展分享平台、移动端分享弹窗、海报生成和微信 JS-SDK 分享。
SEO 与百度资源提交
梳理百度自动推送、普通收录、快速收录、提交结果缓存和重试边界。
插件制作指南
制作可独立安装、停用和复用的子比主题扩展插件。
子主题制作指南
制作承载站点样式、模板覆盖和主题级配置的子主题。
这个阶段的原则是：能用配置解决的先用配置，能用 Hook 解决的不要改核心模板，能做成插件的业务能力不要塞进子主题。
按网站类型阅读
| 网站类型 | 优先阅读 |
|---|---|
| 博客、资讯站 | 在线部署、主题常用设置、站点框架与导航、首页与归档列表、文章正文、SEO、分享 |
| 教程文档站 | 文章正文、古腾堡块、目录树、图片灯箱、搜索体系、SEO、百度提交 |
| 资源下载站 | 用户系统、Zibpay、付费下载、媒体上传、用户资产、内容审核 |
| 会员资源站 | 登录注册、用户成长、VIP 会员、积分余额、付费内容、消息通知 |
| 实物商城 | 商城模块、商品字段、购物车、发货售后、优惠码、商城用户中心 |
| 社区论坛 | 用户系统、论坛模块、论坛排序、论坛小工具、消息通知、内容审核 |
| 定制开发项目 | 源码结构、Codestar Framework、主题扩展、Hook、Ajax、模板覆盖、插件制作 |
开发者阅读顺序
如果你的目标是做二次开发，而不是只配置站点，建议按这个顺序：
- 源码结构：知道主题目录和模块位置。
- 加载顺序：知道文件什么时候加载。
- 数据模型：理解文章、用户、论坛、商城、订单和 meta。
- 主题函数：先复用主题已有函数。
- Hook 与过滤器：用 Action 和 Filter 做无侵入扩展。
- Ajax 动作：理解 nonce、权限、返回格式和缓存边界。
- Codestar Framework：扩展后台设置、Meta、小工具和自定义字段。
- 模板覆盖：最后再考虑覆盖模板。
示例代码尽量保持子比主题风格：命名函数、array()、WordPress Hook、Ajax action、_pz()、zib_get_*_meta()、zib_update_*_meta()、zib_send_json_success() 和 zib_send_json_error()。
遇到问题怎么回到路线
| 现象 | 回到哪一步 |
|---|---|
| 页面打不开 | 第一阶段，检查 DNS、站点绑定、HTTPS、伪静态 |
| 样式或导航不对 | 第二阶段，检查主题设置、菜单、背景、明暗模式 |
| 首页不会搭 | 第三阶段，检查模块、小工具、页面设置、归档列表 |
| 文章展示异常 | 第四阶段，检查文章模板、正文 Hook、古腾堡块、媒体 |
| 登录注册失败 | 第五阶段，检查 SMTP、验证码、人机验证、Ajax、缓存 |
| 支付或订单异常 | 第六阶段，检查 Zibpay、回调、HTTPS、缓存、订单状态 |
| 论坛权限异常 | 第七阶段，检查板块、帖子、用户权限和发帖限制 |
| 想做功能扩展 | 第八阶段，先找 Hook、Ajax、短代码、模板和 Codestar 入口 |
本页吸收了子比官网“教程阅读指引及建议学习顺序”公开文章，并结合本站已蒸馏的部署、配置、主题扩展、Codestar Framework、商城、论坛、用户和 AI 功能文档整理。