入门 Zed Industries 2026-09-14 17:42:20 · 71 阅读

第134章 图标主题扩展开发指南

扩展可以提供图标主题,用来更换 Zed 中文件夹和文件所使用的图标。

扩展示例

Material Icon Theme 是一个包含图标主题的扩展结构的示例。

目录结构

图标主题扩展有两个重要的目录:

  • icon_themes:该目录存放一个或多个 JSON 文件,其中包含图标主题的定义。
  • icons:该目录存放扩展附带的图标资源,可根据需要在其中创建子目录。

每个图标主题文件都应符合 https://zed.dev/schema/icon_themes/v0.3.0.json 中定义的 JSON schema。

以下是一个图标主题结构的示例:

{
  "$schema": "https://zed.dev/schema/icon_themes/v0.3.0.json",
  "name": "My Icon Theme",
  "author": "Your Name",
  "themes": [
    {
      "name": "My Icon Theme",
      "appearance": "dark",
      "directory_icons": {
        "collapsed": "./icons/folder.svg",
        "expanded": "./icons/folder-open.svg"
      },
      "named_directory_icons": {
        "stylesheets": {
          "collapsed": "./icons/folder-stylesheets.svg",
          "expanded": "./icons/folder-stylesheets-open.svg"
        }
      },
      "chevron_icons": {
        "collapsed": "./icons/chevron-right.svg",
        "expanded": "./icons/chevron-down.svg"
      },
      "file_stems": {
        "Makefile": "make"
      },
      "file_suffixes": {
        "mp3": "audio",
        "rs": "rust"
      },
      "file_icons": {
        "audio": { "path": "./icons/audio.svg" },
        "default": { "path": "./icons/file.svg" },
        "make": { "path": "./icons/make.svg" },
        "rust": { "path": "./icons/rust.svg" }
        // ...
      }
    }
  ]
}


每个图标路径都相对于扩展目录的根目录进行解析。

在此示例中,扩展的结构如下:

extension.toml
icon_themes/
  my-icon-theme.json
icons/
  audio.svg
  chevron-down.svg
  chevron-right.svg
  file.svg
  folder-open.svg
  folder.svg
  rust.svg

评论 (0)