02 配置加载与覆盖（排障第一章）

官方优先级（后者覆盖前者）

1. 远程 .well-known/opencode
2. 全局 ~/.config/opencode/opencode.json
3. OPENCODE_CONFIG
4. 项目根 opencode.json
5. .opencode/ 目录
6. OPENCODE_CONFIG_CONTENT

最稳排障法：强制指定配置

Bash / WSL

export OPENCODE_CONFIG="$HOME/.config/opencode/opencode.json"
opencode

PowerShell

$env:OPENCODE_CONFIG="$HOME\.config\opencode\opencode.json"
opencode

配置探针（确认加载）

• 临时修改 keybinds.variant_cycle 为 <leader>v
• 或修改 theme
• 重启后看是否生效

常见误区

• 在 WSL 运行 OpenCode，却编辑 Windows 用户目录配置文件
• 项目配置覆盖了全局配置却不自知

参考

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