Codex CLI 主题未生效？5 步快速修复

/theme 命令无输出、颜色未变化，或调色板显示异常？Codex CLI 主题问题几乎总是由以下五种原因之一导致。请按顺序逐一排查并修复：

1. 主题尚未安装（最常见）

/theme 仅列出存在于 Codex CLI 主题目录中的主题。若您从未运行过安装脚本，则列表为空，或仅显示默认主题。

修复方法： 首先安装一个调色板：

curl -fsSL https://raw.githubusercontent.com/vufly/bearded-theme-ports/master/scripts/install-codex.sh | sh

然后重新打开终端提示符，再次运行 /theme —— 新调色板应以其精确名称出现在列表中。

2. 启动时存在陈旧的颜色缓存

某些移植版本会在 Codex CLI 启动时缓存颜色。应用主题后，调色板可能显示异常，直至下次启动才会更新。

修复方法： 应用主题后重启 Codex CLI，再使用相同名称重新运行 /theme。若此时显示正确的调色板，则说明问题出在缓存上。

3. 主题名称不匹配

/theme 对主题名称进行完全精确匹配。Tokyo Night 与 tokyo-night 或 TokyoNight 并不等同。

修复方法： 运行不带参数的 /theme，从列表中复制其精确名称，再原样用于应用命令。

4. 调色板文件错误或不完整

从移植脚本复制的调色板文件可能不完整——例如缺失背景色、前景色或语法高亮键值。这将导致大部分颜色仍为默认值，仅个别颜色发生变化。

修复方法： 重新运行安装脚本以获取完整主题；或使用管理工具验证文件完整性：

# Codex Themes CLI 在应用前会校验调色板：
codex-theme validate <name>
codex-theme apply <name>

5. 终端与 CLI 配置不同步

若终端外观正确而 Codex CLI 显示异常（或反之），说明二者读取了不同的配置。CLI 主题仅为调色板——它不会更改您的终端配置文件。

修复方法： 将同一调色板导出至终端与 CLI。Codex Themes CLI 可将完全一致的颜色写入您的终端配置文件，一次应用即可同步两者：

codex-theme export <name> --to-terminal

仍无法解决？

请重置为干净状态：卸载该调色板 → 重启 → 重新安装 → 使用精确名称再次应用。若某特定皮肤存在问题，可浏览 Mono & Terminal 分类 查看最新调色板变体，或查阅 CLI 主题指南 获取完整安装流程。