OpenCode 主题配置指南：3 分钟切换并固定你的色彩方案
项目地址: https://gitcode.com/gh_mirrors/te/termai OpenCode 内置 8 个终端色彩方案，但多数人装完就没再碰过主题配置。本文给出最短路径：一个快捷键完成切换，一段 JSON 固定偏好，再按场景挑出最合适的方案。
⚡ 快速上手：用 Ctrl+T 完成第一次主题切换
启动 OpenCode，在聊天页按 Ctrl+T，打开 Select Theme 对话框。列表包含全部已注册主题，opencode 排在首位，当前主题加粗高亮。
用 ↑/↓ 或 j/k 移动，Enter 确认，Esc 取消。切换即时生效，无需重启，界面当场换色。
确认后，OpenCode 会把主题名写进配置文件的 tui.theme 字段，下次启动仍然生效。
📌 在配置文件里固定主题偏好
不想走对话框，直接改配置文件 .opencode.json：
{
"tui": {
"theme": "gruvbox"
}
}
查找位置包括 $HOME/.opencode.json、$XDG_CONFIG_HOME/opencode/.opencode.json 以及当前目录下的 ./.opencode.json。不配置时，OpenCode 使用默认主题 opencode。在项目根目录放一份本地配置，即可按项目指定主题。
可选名称共 8 个：opencode、catppuccin、dracula、flexoki、gruvbox、monokai、tokyonight、tron。
🎛 按场景挑色彩方案
昏暗环境：选低刺激深色
优先 gruvbox 与 tokyonight。前者色调温暖复古，后者偏冷蓝，背景亮度都压得较低，暗光下长时间注视不刺眼。喜欢高亮霓虹风格的，选 tron。
明亮环境：依赖浅色变体
每个主题的颜色都是成对定义的：Dark 与 Light 两组色值。终端背景是浅色时，自动取浅色变体，无需手动切主题。catppuccin 和 opencode 的浅色变体对比适中，适合白天工位。
长时间编码：压低饱和与对比
选 catppuccin（Mocha/Latte 双变体）或 flexoki。两者饱和度低，状态色不抢眼，比高对比主题更适合连续数小时的会话。
文档阅读：弱化装饰色
flexoki 偏文档风格，标题、代码块颜色温和，阅读长 Markdown 更舒服。opencode 也适合日常阅读。
团队协作：统一视觉标准
约定全组使用默认主题 opencode。日志、截图、diff 视图颜色口径一致，排查问题时不用来回对齐"你截图里的红色是什么"。
🛠 从零写一个自定义主题
入口是 internal/tui/theme/theme.go 中的 Theme 接口。每个颜色槽位都是 lipgloss.AdaptiveColor，必须同时给出 Dark 和 Light 两个色值。嵌入 BaseTheme，只覆盖你要改的槽位：
theme := &MyTheme{}
theme.PrimaryColor = lipgloss.AdaptiveColor{
Dark: "#fab283",
Light: "#3b7dd8",
}
theme.TextMutedColor = lipgloss.AdaptiveColor{
Dark: "#6a6a6a",
Light: "#8a8a8a",
}
再调用 RegisterTheme("mytheme", theme) 注册，主题就会出现在 Ctrl+T 对话框里。可改字段按用途分组：基础色（Primary/Secondary/Accent）、状态色（Error/Warning/Success/Info）、文本与背景、边框、diff 视图、Markdown、语法高亮，均有独立槽位。
⚠️ 排掉这几个高频主题配置问题
1. 报 theme '<name>' not found — 名称拼写或大小写错了。名称必须与注册列表完全一致，例如 catppuccin，不是 Catppuccin。
2. 切换当场生效，重启后又变回去 — 写配置文件那一步失败了，OpenCode 只记一条警告日志，不会报错。检查 .opencode.json 里 tui.theme 是否真的被写入。
3. 对比度不足，文字发灰难读 — 常见原因是 TextMuted 与 Background 亮度太接近。自定义主题时保留明显亮度差，并放大字号实测。
4. 浅色终端里"看着不对" — 浅色背景自动应用浅色变体。如果深色终端下预览过、到浅色终端落差大，先在浅色背景重新评估，再决定保留还是换主题。
场景选型速查
| 场景 | 推荐主题 | 理由 |
|---|---|---|
| 昏暗环境、夜间 | gruvbox、tokyonight | 低亮度，刺激小 |
| 明亮环境 | catppuccin、opencode | 浅色变体对比适中 |
| 长时间编码 | catppuccin、flexoki | 低饱和，久看不累 |
| 文档阅读 | flexoki | 文档风，颜色温和 |
| 团队统一标准 | opencode | 默认主题，口径一致 |
主题源码在 internal/tui/theme/ 目录，配置文件格式见 README.md。完成切换、固定、校验三步后，这套 OpenCode 主题配置即可长期使用，无需再动。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
