Codex 主题安装失败？7 个常见问题排查

Codex Skin Studio 让换肤变得简单，但有时候主题装不上。别急，这篇文章覆盖 7 个最常见的安装失败原因和解决方法。

1. 检查 .codedrobe 文件格式

Codex 只接受 .codedrobe 或 .tmTheme 格式。如果你下载的是 .json 或 .xml 文件，直接改扩展名不会生效。需要用 Codex Skin Studio 导出为 .codedrobe。

2. 确认主题路径正确

Mac: ~/.codex/themes/，Windows: %USERPROFILE%\.codex\themes。路径错了主题不会被加载。

3. 重启 Codex 而非只是关闭窗口

Codex 启动时读取主题。如果只是点 X 关闭窗口，进程可能还在后台运行。完全退出（Cmd+Q 或 Task Manager 结束进程）再重新启动。

4. 检查文件权限

Mac/Linux: chmod 644 your-theme.codedrobe。Windows: 右键文件 → 属性 → 确保没有勾选只读。

5. 确认 CSS 变量语法

主题文件中的 CSS 变量名必须正确：--background, --foreground 等。拼写错误会导致主题加载失败。

6. 查看 Codex 控制台错误

打开 Codex 开发者工具（Ctrl+Shift+I 或 Cmd+Option+I），查看 Console 标签页的错误信息。绝大多数安装失败会在这里留下线索。

7. 重新下载或重新导出

如果以上都不行，可能是文件损坏。重新从 Codex Skin Studio 导出，或重新下载主题文件。

FAQ