删除 .cc-switch 目录后仍然无法启动怎么办？

有用户反馈仅删除目录不够，需要使用强力卸载/清理工具清理注册表或残留配置后重新安装。若日志显示 database is locked，还需确认没有残留 CC Switch 进程占用数据库。

WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--no-sandbox 一定有效吗？

不一定。issue 中有用户通过该方法解决白屏，也有用户反馈无效。它主要针对 WebView2 安全策略或沙箱冲突场景，不是通用修复。

任务管理器里有进程，但窗口看不见，是崩溃吗？

可能是窗口状态文件记录了异常尺寸，例如 2×2 像素。关闭进程后修改 .window-state.json 中的 width/height 再启动。

GUI 一直打不开，有没有替代方案？

维护者在多个 issue 中建议尝试 CLI 版：https://github.com/SaladDay/cc-switch-cli，尤其是 Tauri 2 对系统环境要求较高导致 GUI 无法启动的情况。

点击“设置 -> 关于”导致崩溃也属于启动崩溃吗？

不是严格意义上的启动崩溃，但在 WSL/Linux/macOS 的 issue 中有用户报告打开 About 页面会卡死或闪退。该问题与启动白屏/闪退集群相关但根因不同。

cc-switch 启动白屏 / 黑屏 / 闪退 / 无界面（launch crash）

Quick fix

先区分是窗口状态损坏、WebView2/系统兼容问题，还是安全软件拦截；按日志和现象分别处理，必要时改用 CLI 版。

Symptom

报错原文

either event handler is re-entrant (likely), or no event handler is registered (very unlikely)

Cause

该集群包含多种不同的启动失败现象：启动后白屏/黑屏、进程存在但无界面、双击无反应、启动后立即闪退，以及 crash report 中出现 tao 事件循环错误。它们并不是同一个根因。

从 issue 中可确认的机制包括：1) Tauri 窗口状态文件保存了异常尺寸（如 width: 2, height: 2），导致下次启动时窗口不可见；2) Windows 上 WebView2/系统版本或安全软件（如天锐绿盾、IP-Guard、Astrill VPN 等）与 Tauri/WebView2 冲突，导致窗口创建失败或白屏；3) 旧版本中 titleBarStyle Overlay 在 Windows WebView2 下有兼容性问题；4) 维护者多次指出 Tauri 2 对系统环境要求较高，部分旧系统或受限环境会直接无法启动，此时可考虑 CLI 版。另有用户通过设置 WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--no-sandbox 解决部分 WebView2 白屏，但反馈并不一致。

Fix

1
如果任务管理器中有 CC Switch 进程但看不到窗口，先完全退出 CC Switch，然后检查窗口状态文件是否保存了异常宽高。
C:\Users\<用户名>\AppData\Roaming\com.ccswitch.desktop\.window-state.json
```
# 将 width 和 height 从异常值（例如 2 x 2）改为正常尺寸，如 1200 x 800 后重新启动
{
  "width": 1200,
  "height": 800
}
```
如果启动后白屏且怀疑是 WebView2/安全软件冲突，可尝试设置系统环境变量 WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS 为 --no-sandbox，然后重启电脑。注意：issue 中该方法只在部分 WebView2 冲突场景有效，并非适用于所有白屏。
如果电脑安装了企业安全软件（如天锐绿盾、IP-Guard 等）或 VPN 软件，尝试临时关闭/卸载相关软件后再启动 cc-switch；或先启动 cc-switch 再启动安全软件。
如果问题出现在旧版本 Windows 或 macOS 上，且上述方法无效，升级系统到较新版本；issue 中有用户将 Windows 更新到 24H2 后恢复。如果仍无法启动，可改用社区 CLI 版：https://github.com/SaladDay/cc-switch-cli

Affected Versions

Toolcc-switch

Version3.8.2 - 3.16.2（语料中报告过的最高版本）

PlatformsWindowsmacOSLinux

Source Issues

本页汇总自 14 个真实 issue

FAQ

删除 .cc-switch 目录后仍然无法启动怎么办？: 有用户反馈仅删除目录不够，需要使用强力卸载/清理工具清理注册表或残留配置后重新安装。若日志显示 database is locked，还需确认没有残留 CC Switch 进程占用数据库。
WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--no-sandbox 一定有效吗？: 不一定。issue 中有用户通过该方法解决白屏，也有用户反馈无效。它主要针对 WebView2 安全策略或沙箱冲突场景，不是通用修复。
任务管理器里有进程，但窗口看不见，是崩溃吗？: 可能是窗口状态文件记录了异常尺寸，例如 2×2 像素。关闭进程后修改 .window-state.json 中的 width/height 再启动。
GUI 一直打不开，有没有替代方案？: 维护者在多个 issue 中建议尝试 CLI 版：https://github.com/SaladDay/cc-switch-cli，尤其是 Tauri 2 对系统环境要求较高导致 GUI 无法启动的情况。
点击“设置 -> 关于”导致崩溃也属于启动崩溃吗？: 不是严格意义上的启动崩溃，但在 WSL/Linux/macOS 的 issue 中有用户报告打开 About 页面会卡死或闪退。该问题与启动白屏/闪退集群相关但根因不同。

cc-switch 启动白屏 / 黑屏 / 闪退 / 无界面（launch crash）

Symptom

Cause

Fix

Affected Versions

Source Issues

FAQ

相关问题