主题目录规范

最后更新时间:2026-05-03 10:00:00

1. 主题目录应该先分层

一个可维护的主题,不能把所有文件堆在一起。最基础的分层方式是把“模板、静态资源、配置数据、演示数据”分开。

2. 推荐的目录结构

theme-name/
  info.json
  vvdata.json
  init_data.json
  screenshot.png
  views/
  static/

其中 views 放模板,static 放 CSS、JS、图片,vvdata.json 放主题配置,init_data.json 放演示数据。

3. 为什么要这样分

  • 模板和静态资源职责分离。
  • 配置和内容演示可以独立维护。
  • 后续换皮肤时,只改视觉层,不动数据结构。

4. 不建议的做法

  • 不要把所有图片、脚本、样式都塞进 `views`。
  • 不要把业务配置写死在模板里。
  • 不要让静态资源路径散落在多个地方。

5. 目录规范的核心价值

目录结构清楚,AI 才能稳定生成主题;人接手维护时,也更容易判断哪个文件负责什么。