Z-Blog 主题开发从零开始：theme.xml 里真正要写的只有几行
摘要
第一次看别人的 theme.xml 容易懵，字段一大串。其实跑起来必需的只有 ID、Name、Author、Path 这几项，其余都是给后台展示用的。 最小可运行结构
第一次看别人的 theme.xml 容易懵，字段一大串。其实跑起来必需的只有 ID、Name、Author、Path 这几项，其余都是给后台展示用的。
最小可运行结构
<theme> <id>MyTheme</id> <name>我的主题</name> <author>you</author> <path>main.php</path> <include>include.php</include> </theme>
include.php 是可选的，但只要你要挂钩子、注册自定义字段，就必须有。
模板文件的命名规则
Z-Blog 按「文件名 = 页面类型」找模板：index.php、single.php、list.php、catalog.php、search.php、404.php。少一个不会报错，会自动回退到 index.php——这也是为什么很多人「改了 single.php 没反应」，其实是文件根本没被命中。
必踩的两个坑
path指错，整个主题在后台看不到。- 改动 theme.xml 后必须去后台「主题管理」重新保存一次，缓存才会刷新。
所属专题
2026年10月21日 12:42
前后30天 · 点日期看归档
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日
11月6日
11月7日
11月8日
11月9日
11月10日
11月11日
11月12日
11月13日
11月14日
11月15日
11月16日
11月17日
11月18日
11月19日
11月20日