启动失败 / 白屏排查

症状

双击/命令行启动无反应、白屏、或闪退。

原因

1. 运行库缺失（webkit 等，见症状 1）；

2. `~/.cc-switch/config.json` 损坏或与版本不兼容；

3. 共享配置被其它工具改写（~/.claude.json / ~/.codex/config.toml 段结构不匹配）。

解法

1. 依赖自查：`ldd /usr/bin/cc-switch | grep 'not found'`——有输出说明缺库，apt 补装。

2. 配置备份后重试：备份 `~/.cc-switch/` 后删除让其重建。

3. 终端启动看报错：`cc-switch`（保留 stderr 输出）。

4. 共享配置段异常：检查 ~/.claude.json 的 provider 段 JSON 合法性（cc-switch 只改 provider 段，不碰插件注册段）。

验证证据

- 网页案例：CSDN 启动失败排查场景。

- 本市场实测：无 GUI 库环境二进制不可运行（如实标注，）；管理面 = ~/.cc-switch/config.json + ~/.claude.json + ~/.codex/config.toml（二进制字符串审计，）。