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": "我的文件主题", "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 仅允许加载位于你家目录(home directory)内的主题文件。若尝试从家目录以外的位置加载主题,系统将显示警告,且该主题不会被加载。此举旨在防止从不可信来源加载潜在恶意的主题文件。

自定义主题示例

使用你的自定义主题

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

主题预览

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