10 Troubleshooting（日志/缓存/插件三板斧）

三板斧

1. 看日志

• macOS/Linux：~/.local/share/opencode/log/
• Windows：%USERPROFILE%\.local\share\opencode\log
• 调试：opencode --log-level DEBUG

2. 禁用插件

• 临时设置：{"plugin": []}
• 或移走 ~/.config/opencode/plugins/ 与 .opencode/plugins/

3. 清缓存

• macOS/Linux：~/.cache/opencode
• Windows：%USERPROFILE%\.cache\opencode

症状速查

• 配置不生效：先强制 OPENCODE_CONFIG，再做 keybind/theme 探针
• /models 看不到模型：检查 provider.<id>.models.<id> 与 model 引用格式
• variant 不切换：优先排查 Ctrl+T 冲突，改 <leader>v
• ProviderInitError / AI_APICallError：重连 /connect + 清缓存

参考

• https://opencode.ai/docs/troubleshooting/