Skip to Content
用户指南配置主题

主题

Qwen Code 支持多种主题,用于自定义其配色方案和外观。你可以通过 /theme 命令或 "theme": 配置项来更改主题,以符合个人偏好。

可用主题

Qwen Code 内置了一系列预定义主题,你可以在 CLI 中使用 /theme 命令查看这些主题:

  • 暗色主题:
    • ANSI
    • Atom One
    • Ayu
    • Default
    • Dracula
    • GitHub
  • 亮色主题:
    • ANSI Light
    • Ayu Light
    • Default Light
    • GitHub Light
    • Google Code
    • Xcode

更改主题

  1. 在 Qwen Code 中输入 /theme
  2. 将出现一个对话框或选择提示,列出可用的主题。
  3. 使用方向键选择一个主题。某些界面在你选择时可能会提供实时预览或高亮显示。
  4. 确认你的选择以应用该主题。

注意: 如果在你的 settings.json 文件中定义了某个主题(通过名称或文件路径),则必须先从该文件中移除 "theme" 设置,然后才能使用 /theme 命令更改主题。

主题持久化

所选主题会保存在 Qwen Code 的 配置 中,这样你的偏好设置会在不同会话之间被记住。


自定义颜色主题

Qwen Code 允许你在 settings.json 文件中指定自定义颜色主题。这使你可以完全控制 CLI 中使用的调色板。

如何定义自定义主题

在你的用户、项目或系统 settings.json 文件中添加一个 customThemes 块。每个自定义主题都定义为一个具有唯一名称和一组颜色键的对象。例如:

{ "ui": { "customThemes": { "MyCustomTheme": { "name": "MyCustomTheme", "type": "custom", "Background": "#181818", ... } } } }

颜色键:

  • Background
  • Foreground
  • LightBlue
  • AccentBlue
  • AccentPurple
  • AccentCyan
  • AccentGreen
  • AccentYellow
  • AccentRed
  • Comment
  • Gray
  • DiffAdded(可选,用于差异中的新增行)
  • DiffRemoved(可选,用于差异中的删除行)
  • DiffModified(可选,用于差异中的修改行)

必需属性:

  • name(必须与 customThemes 对象中的键匹配且为字符串)
  • type(必须是字符串 "custom"
  • Background
  • Foreground
  • LightBlue
  • AccentBlue
  • AccentPurple
  • AccentCyan
  • AccentGreen
  • AccentYellow
  • AccentRed
  • Comment
  • Gray

你可以使用十六进制代码(例如 #FF0000标准 CSS 颜色名称(例如 coraltealblue)作为任何颜色值。有关支持的名称完整列表,请参见 CSS 颜色名称 

你可以通过向 customThemes 对象添加更多条目来定义多个自定义主题。

从文件加载主题

除了在 settings.json 中定义自定义主题外,你还可以通过在 settings.json 中指定文件路径来直接从 JSON 文件加载主题。这对于共享主题或将它们与主配置分离非常有用。

要从文件加载主题,请将 settings.json 中的 theme 属性设置为你的主题文件路径:

{ "ui": { "theme": "/path/to/your/theme.json" } }

主题文件必须是有效的 JSON 文件,并且结构与在 settings.json 中定义的自定义主题相同。

示例 my-theme.json

{ "name": "My File Theme", "type": "custom", "Background": "#282A36", "Foreground": "#F8F8F2", "LightBlue": "#82AAFF", "AccentBlue": "#61AFEF", "AccentPurple": "#BD93F9", "AccentCyan": "#8BE9FD", "AccentGreen": "#50FA7B", "AccentYellow": "#F1FA8C", "AccentRed": "#FF5555", "Comment": "#6272A4", "Gray": "#ABB2BF", "DiffAdded": "#A6E3A1", "DiffRemoved": "#F38BA8", "DiffModified": "#89B4FA", "GradientColors": ["#4796E4", "#847ACE", "#C3677F"] }

安全提示: 为了你的安全,Gemini CLI 只会加载位于你的主目录内的主题文件。如果你尝试从主目录之外加载主题,将会显示警告并且不会加载该主题。这是为了防止从不受信任的来源加载可能含有恶意代码的主题文件。

示例自定义主题

使用你的自定义主题

  • 在 Qwen Code 中使用 /theme 命令选择你的自定义主题。你的自定义主题将出现在主题选择对话框中。
  • 或者,通过在 settings.jsonui 对象中添加 "theme": "MyCustomTheme" 将其设置为默认主题。
  • 自定义主题可以在用户、项目或系统级别进行设置,并遵循与其他设置相同的配置优先级规则。

主题预览

深色主题预览浅色主题预览
ANSIANSI Light
Atom OneDarkAyu Light
Ayu Default Light
DefaultGitHub Light
DraculaGoogle Code
GitHub Xcode
Last updated on