主题包结构

了解导出主题包中包含的文件,以及 Chrome 安装后可能生成的缓存文件。


用创作器导出 ZIP 并解压后,常见结构大致是:

my-theme/
|-- manifest.json      ← 主题配置(名称、颜色、图片路径、图标等)
|-- images/            ← 背景图、外框图等
`-- icons/
    `-- icon-128.png   ← 商店 / 扩展管理页图标(始终会有)

创作器会在导出时写入 128×128icons/icon-128.png,并在 manifest.json 里声明 icons["128"]。你可以在「Chrome 商店上架」里上传自定义商店图标;不填时会优先使用背景图生成,没有背景图时再按主题色和名称首字母生成。

安装后多出来的文件:Cached Theme.pak

把主题加载到 Chrome 之后,主题文件夹里通常还会出现:

my-theme/
|-- manifest.json
|-- images/
|-- icons/
`-- Cached Theme.pak   ← Chrome 自动生成的缓存包

Cached Theme.pak 是 Chrome 安装主题时自动生成的缓存文件,用于提高加载速度。无需手动创建或编辑,创作器导出的 ZIP 通常也不会包含该文件。

使用时请注意:

  • 不用自己创建或编辑这个文件
  • 检查其他已安装主题的文件时,看到该文件属于正常现象
  • 若你在本地改了图片或 manifest.json 后外观没更新,可删掉 Cached Theme.pak,再重新加载主题,让 Chrome 按新文件重新生成缓存;仍无效时,到 设置 → 外观 → 重置为默认 后再加载一次(详见 常见问题

使用时需要注意的内容

大多数时候,用创作器导出即可,不必手改这些文件。

手动检查主题包时,请确认以下三点:

  1. 解压后的根目录里要有配置文件 manifest.json
  2. 图片要放在包里,路径要能对上(不能写网上的外链图片)
  3. 包内应有 icons/icon-128.png(上架 Chrome 网上应用店需要;创作器导出时会自动生成)

配置文件包含的内容

  • 主题名称、版本、简介
  • 商店图标路径(icons
  • 颜色、图片、布局等外观设置

更细的每一项说明见 可调样式一览