主题

Gemini CLI 支持多种主题以自定义其颜色方案和外观。您可以通过 /theme 命令或 "theme": 配置设置来更改主题以适应您的偏好。

可用主题

Gemini CLI 附带了一系列预定义的主题，您可以使用 Gemini CLI 中的 /theme 命令来列出它们：

深色主题：
- ANSI
- Atom One
- Ayu
- Default
- Dracula
- GitHub
浅色主题：
- ANSI Light
- Ayu Light
- Default Light
- GitHub Light
- Google Code
- Xcode

更改主题

在 Gemini CLI 中输入 /theme。
出现一个对话框或选择提示，列出可用的主题。
使用箭头键选择一个主题。某些界面可能提供实时预览或在您选择时高亮显示。
确认您的选择以应用主题。

注意： 如果您的 settings.json 文件中定义了主题（通过名称或文件路径），则在使用 /theme 命令更改主题之前，您必须从文件中删除 "theme" 设置。

主题持久性

选定的主题保存在 Gemini CLI 的配置中，因此您的偏好会在会话之间被记住。

自定义颜色主题

Gemini CLI 允许您通过在 settings.json 文件中指定来自定义自己的颜色主题。这使您能够完全控制 CLI 中使用的颜色调色板。

如何定义自定义主题

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

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

颜色键：

【术语表】

CLI: CLI（命令行界面）
command-line interface: 命令行界面
Shell: Shell
Bash: Bash
API: API
endpoint: 端点
token: 令牌
Model Context Protocol: 模型上下文协议（MCP）
MCP: MCP
Markdown: Markdown
JSON: JSON
YAML: YAML
Mermaid: Mermaid
npm: npm
pip: pip
git: git
repository: 仓库
package: 包
dependency: 依赖
configuration: 配置
environment variable: 环境变量
workspace: 工作空间
directory: 目录
file: 文件
script: 脚本
plugin: 插件
extension: 扩展
integration: 集成
authentication: 认证
authorization: 授权
credential: 凭证
session: 会话
context: 上下文
prompt: 提示词
completion: 补全
streaming: 流式
model: 模型
provider: 提供商
service: 服务
request: 请求
response: 响应
header: 头部
body: 主体
payload: 负载
error: 错误
exception: 异常
warning: 警告
debug: 调试
logging: 日志
telemetry: 遥测
analytics: 分析
monitoring: 监控
performance: 性能
latency: 延迟
throughput: 吞吐量
concurrency: 并发
thread: 线程
process: 进程
daemon: 守护进程
background: 背景
foreground: 前台
interactive: 交互式
batch: 批处理
queue: 队列
cache: 缓存
database: 数据库
storage: 存储
memory: 内存
disk: 磁盘
network: 网络
protocol: 协议
HTTP: HTTP
HTTPS: HTTPS
WebSocket: WebSocket
REST: REST
GraphQL: GraphQL
RPC: RPC
SDK: SDK
library: 库
framework: 框架
runtime: 运行时
build: 构建
deploy: 部署
release: 发布
version: 版本
changelog: 更新日志
migration: 迁移
compatibility: 兼容性
breaking change: 破坏性变更
feature: 功能
bug fix: 错误修复
improvement: 改进
enhancement: 增强
refactor: 重构
documentation: 文档
tutorial: 教程
example: 示例
demo: 演示
test: 测试
unit test: 单元测试

【原文翻译】

Background
Foreground
LightBlue
AccentBlue
AccentPurple
AccentCyan
AccentGreen
AccentYellow
AccentRed
Comment
Gray
DiffAdded （可选，用于差异中的添加行）
DiffRemoved （可选，用于差异中的删除行）
DiffModified （可选，用于差异中的修改行）

您还可以通过添加一个嵌套的text对象来覆盖单个UI文本角色。此对象支持以下键：primary、secondary、link、accent和 response。当提供text.response时，它优先于 text.primary用于在聊天中呈现模型响应。

必填属性：

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

您可以使用

主题文件必须是有效的 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"]
}