Z-Blog 主题从零写起：theme.xml 里每一行都是干什么的

2026-10-01 · zblog · 阅读 15

摘要

很多人做 Z-Blog 主题，第一步是拷别人的目录改个名。能跑，但一出问题就抓瞎。我把 theme.xml 拆开讲一遍。就十来个标签，看完你能自己写。它到底是什么theme.xml 不是配置文件。它是主题的身份证明。后台主题列表能显示你的主

很多人做 Z-Blog 主题，第一步是拷别人的目录改个名。能跑，但一出问题就抓瞎。

我把 theme.xml 拆开讲一遍。就十来个标签，看完你能自己写。

它到底是什么

theme.xml 不是配置文件。它是主题的身份证明。后台主题列表能显示你的主题，靠的就是读这个文件。

缺了它，目录放在 theme 下面也不会出现。

ID。全局唯一，也是目录名。写错了，启用时会报找不到主题。

Name。后台看到的名字，可以中文。

Author。作者名。

Version。版本号。改主题记得加，有些缓存判断会用到。

这四个是硬的。少了后台直接不认。

Description 是一句话简介。没有也能跑，就是后台那块空着。

Style 定义样式方案。主题如果做了深色浅色两套，在这里列出来，用户在主题管理里能切。不做就省略。

Adaptive、Mobile 这类标签在老版本里常见，新版意义不大，写不写都行。

XML 里不能有裸的 & 符号，也不能有中文引号和注释里的双横线。我见过有人写 Description 时塞了一句“最好看&最快”，整个主题加载失败，报错还指不到这一行。

改完记得看后台主题页能不能正常打开。打不开，先去查 theme.xml。

theme.xml 只负责让主题被识别。真正渲染页面的是 index.php 和模板文件，那条线我在《Z-Blog 主题模板文件清单》里写过了。

先保证能启用，再谈模板。顺序别反。

标签

2026年10月01日 09:12 前后30天 · 点日期看归档

9月1日 9月2日 9月3日 9月4日 9月5日 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日