主题
Qwen Code 支持多种主题,用于自定义其配色方案和外观。你可以通过 /theme 命令或 "theme": 配置项来更改主题,以符合你的个人偏好。
可用主题
Qwen Code 内置了一系列预定义主题,你可以在 CLI 中使用 /theme 命令查看这些主题列表:
- 暗色主题:
ANSIAtom OneAyuDefaultDraculaGitHub
- 亮色主题:
ANSI LightAyu LightDefault LightGitHub LightGoogle CodeXcode
更换主题
- 在 Qwen Code 中输入
/theme。 - 将出现一个对话框或选择提示,列出可用的主题。
- 使用方向键选择一个主题。某些界面在你选择时可能会提供实时预览或高亮显示。
- 确认你的选择以应用该主题。
注意: 如果你的 settings.json 文件中已定义了某个主题(通过名称或文件路径),则必须先从该文件中移除 "theme" 设置,然后才能使用 /theme 命令更改主题。
主题持久化
所选主题会保存在 Qwen Code 的 配置 中,这样你的偏好设置会在不同会话之间被记住。
自定义颜色主题
Qwen Code 允许你在 settings.json 文件中指定自定义颜色主题。这让你可以完全控制 CLI 中使用的调色板。
如何定义自定义主题
在你的 user、project 或 system 级别的 settings.json 文件中添加一个 customThemes 块。每个自定义主题都定义为一个具有唯一名称和一组颜色键的对象。例如:
{
"ui": {
"customThemes": {
"MyCustomTheme": {
"name": "MyCustomTheme",
"type": "custom",
"Background": "#181818",
...
}
}
}
}颜色键(Color keys):
BackgroundForegroundLightBlueAccentBlueAccentPurpleAccentCyanAccentGreenAccentYellowAccentRedCommentGrayDiffAdded(可选,用于 diff 中新增的行)DiffRemoved(可选,用于 diff 中删除的行)DiffModified(可选,用于 diff 中修改的行)
必需属性(Required Properties):
name(必须与customThemes对象中的键匹配,且为字符串)type(必须是字符串"custom")BackgroundForegroundLightBlueAccentBlueAccentPurpleAccentCyanAccentGreenAccentYellowAccentRedCommentGray
你可以使用十六进制颜色代码(例如 #FF0000)或标准 CSS 颜色名称(例如 coral、teal、blue)作为任何颜色值。有关支持的颜色名称完整列表,请参见 CSS color names 。
你可以通过向 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 只会加载位于你主目录(home directory)内的主题文件。如果你尝试加载主目录外的主题文件,系统将显示警告并且不会加载该主题。此举是为了防止从不受信任的来源加载可能存在风险的主题文件。
自定义主题示例
使用你的自定义主题
- 在 Qwen Code 中使用
/theme命令选择你的自定义主题。你的自定义主题将出现在主题选择对话框中。 - 或者,通过在
settings.json文件中的ui对象下添加"theme": "MyCustomTheme"来将其设为默认主题。 - 自定义主题可以在用户、项目或系统级别进行设置,并且遵循与其他设置相同的配置优先级规则。
暗色主题
ANSI
Atom OneDark
Ayu
Default
Dracula
GitHub
浅色主题
ANSI Light
Ayu Light
Default Light
GitHub Light
Google Code
Xcode
