Z-Blog 主题怎么打包发布：目录结构、版本号和更新策略

2026-10-06 · zblog · 阅读 11

摘要

主题做好了，想给别人用。打包这一步有讲究，做不好装上去就报错。目录结构根目录下必须有 theme.xml、index.php。缺一个都装不上。样式放 style 目录，模板可以直接放根目录。include.php 如果要用，也放根目录。别打

主题做好了，想给别人用。打包这一步有讲究，做不好装上去就报错。

目录结构

根目录下必须有 theme.xml、index.php。缺一个都装不上。

样式放 style 目录，模板可以直接放根目录。include.php 如果要用，也放根目录。

备份文件。.aicbak、.bak、~ 结尾的，全部清掉。

本地开发用的测试文件、临时脚本、编辑器配置目录，也清掉。

这些东西不影响运行，但会让包变大，也显得不专业。

打包后解压出来，应该直接是一个以主题 ID 命名的文件夹，而不是散在根目录的一堆文件。

用户装的时候是解压到 theme 目录下，结构不对就变成满目录乱放。

第一次发布 1.0.0。

修 bug 加第三位，1.0.1。

加功能加第二位，1.1.0。

大改重构才动第一位。

别每次都说 1.0。用户没法判断该不该更新。

新版主题如果改了 Config 字段名，老用户升级后设置全丢。

解决办法是在启用时做一次字段迁移：发现旧字段存在，读出来写进新字段，再删旧的。

这一步不做，用户升级一次就骂一次。

全新安装一次。不拷旧数据，从零装上去看能不能正常启用。

这是唯一能暴露缺文件的办法。你本机有缓存，看不出问题。

所属专题

标签

2026年10月06日 22:07 前后30天 · 点日期看归档

9月6日 9月7日 9月8日 9月9日 9月10日 9月11日 9月12日 9月13日 9月14日 9月15日 9月16日 9月17日 9月18日 9月19日 9月20日 9月21日 9月22日 9月23日 9月24日 9月25日 9月26日 9月27日 9月28日 9月29日 9月30日 10月1日 10月2日 10月3日 10月4日 10月5日 10月6日 10月7日 10月8日 10月9日 10月10日 10月11日 10月12日 10月13日 10月14日 10月15日 10月16日 10月17日 10月18日 10月19日 10月20日 10月21日 10月22日 10月23日 10月24日 10月25日 10月26日 10月27日 10月28日 10月29日 10月30日 10月31日 11月1日 11月2日 11月3日 11月4日 11月5日