产品图标参考

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

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

为了实现这一点，所有产品图标都由一个 ID 标识。图标标识符用于 UI 组件的标签中 ($(pencil))，在 API 中作为 ThemeIcon，以及在需要图标的贡献中。

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

标签中的图标

图标可以在悬停时的 Markdown 标签中、状态栏项文本中以及 快速选择项标签 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 库中的所有图标。