产品图标参考

Visual Studio Code 包含一组内置图标，这些图标用于视图和编辑器，也可用于悬停提示、状态栏以及扩展。这些图标是产品图标，而不是在整个 UI 中用于文件名旁边的文件图标。

随 VS Code 提供的产品图标包含在 Codicon 图标字体 中，并构成默认产品图标主题。扩展可以提供新的 产品图标主题 来重新定义这些图标，并为 VS Code 提供新的外观。

为了允许这样做，所有产品图标都由一个 ID 标识。图标标识符用于 UI 组件中的标签（$(pencil)）、API 中的 ThemeIcon 以及需要图标的贡献中。

图标标识符到实际图标字形的关联发生在产品图标主题中。

标签中的图标

图标可用于悬停提示中的 Markdown 标签、StatusBarItem 文本和 QuickPickItem 标签 API。在 Markdown 中添加图标的语法是 $(iconIdentifier)

$(alert);

您还可以嵌入文本并使用多个图标

$(eye) $(heart) $(mark-github) GitHub

要在标签中放置文字 ${...}，请使用反斜杠转义 $

\$(eye)

动画

您可以通过将 ~spin 附加到图标名称来为以下图标应用旋转动画

• sync
• loading
• gear

$(sync~spin)

图标贡献点

图标贡献点允许扩展通过 ID 定义额外的图标，以及一个默认图标。然后，扩展（或依赖该扩展的任何其他扩展）可以在标签（$(iconId)）或可以使用 ThemeIcon 的所有位置（new ThemeIcon("iconId")）中使用该图标 ID。

"contributes": {
  "icons": {
        "distro-ubuntu": {
            "description": "Ubuntu icon",
            "default": {
                "fontPath": "./distroicons.woff",
                "fontCharacter": "\\E001"
            }
        },
        "distro-fedora": {
            "description": "Ubuntu icon",
            "default": {
                "fontPath": "./distroicons.woff",
                "fontCharacter": "\\E002"
            }
        }
    }
}

产品图标主题可以重新定义图标（如果它们知道图标 ID）。

图标列表

以下是按标识符排列的内置产品图标列表。

图标的 ID 标识了图标的使用位置。默认 codicon ID 描述了默认情况下使用的 codicon 库中的哪个图标，预览显示了该图标的外观。

产品图标主题 可以替换每个图标，以及 codicon 库中的所有图标。