Panda 子主题安装教程：上传、激活、Source Guardian 配置一次讲清

Panda 是 Zibll 的子主题，安装顺序不能乱。最稳的做法是先确认父主题、PHP 环境和扩展，再上传子主题并完成首次配置。下面这份教程可以直接当文章发布。

安装前准备

• 先安装并启用父主题 Zibll，Panda 依赖它运行。
• PHP 版本建议放在 7.4 到 8.3 之间，更容易稳定通过安装检查。
• 正式服务器建议提前准备 Source Guardian / sg16 扩展。
• 如果是本地测试站点，可以先预览主题效果，再处理扩展安装。

1. 上传主题

把主题文件上传到 WordPress 的主题目录，路径通常是：

/wp-content/themes/panda/

• 如果你用后台安装，进入“外观 – 主题 – 添加新主题 – 上传主题”。
• 如果你用 FTP / 文件管理器，直接把 panda 文件夹放到 wp-content/themes/ 下。
• 确认父主题 zibll 已经在同级目录中，不要漏装。

2. 启用 Panda 子主题

进入“外观 – 主题”，找到 Panda 子主题并点击启用。启用后，主题通常会自动跳到 Panda子主题设置 页面，方便你继续配置。

如果首页已经出现主题风格，说明主题主体部分已经开始正常加载。

3. 处理 Source Guardian 提示

如果后台弹出扩展提示，按页面里的安装向导处理即可。一般步骤是：在服务器面板里搜索 sg16 或 Source Guardian，安装后重启 PHP 服务，再刷新页面确认状态。

• 宝塔、1Panel 这类面板，一般可以直接在 PHP 扩展里安装。
• Docker 环境需要先确认容器基础镜像，再按对应方式安装 Loader。
• 安装完成后记得重启 PHP 或容器，不然状态不会更新。

4. 首次配置建议

• 先打开 Panda子主题设置，确认基础选项正常。
• 优先看 服务、文档与维护 里的更新日志和备份与导入。
• 再去设置首页样式、菜单、小工具和文章展示方式。
• 如果你之前有旧配置，可以先备份再导入，省很多时间。

常见问题

1. 只看到父主题，没有 Panda 样式？
通常是子主题没启用，或者父主题 Zibll 没装完整。

2. 线上提示 Source Guardian，但本地没提示？
本地测试环境可能不会强制拦截，正式服务器还是要按向导把扩展装好。

3. 启用后页面空白或报错？
先检查 PHP 版本，再确认 Source Guardian 是否已安装，最后看主题目录是否完整。

这样处理完以后，Panda 子主题就能正常进入后台设置和前台预览了。后续如果还要写“首页配置”“小工具设置”或者“备份导入”教程，可以直接接着这篇文章继续发。