产品图标参考

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 定义附加图标，并提供一个默认图标。然后，该图标 ID 可以由扩展程序（或依赖于该扩展程序的任何其他扩展程序）用于标签 ($(iconId)) 或所有可以使用 ThemeIcon 的地方 (new ThemeIcon("iconId"))。

"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 库的所有图标。