界面不会自动刷新,只有手动拖动窗口才会触发 UI 重绘 - cc-switch
Quick fix
升级至 v3.13.0+ 修复 Linux 界面卡死;Windows 内置管理员需修改注册表以正常显示主界面。
Symptom
Section titled “Symptom”界面不会自动刷新,只有手动拖动窗口才会触发 UI 重绘该问题主要源于 Tauri 2 与 WebKitGTK 在部分 Linux 发行版(如 Debian 13、Ubuntu 24.04)上的渲染事件兼容性缺陷,导致点击输入框卡死或初始白屏。官方在 v3.13.0 中通过内置 WEBKIT_DISABLE_COMPOSITING_MODE=1 及引入焦点修复函数解决了此问题。此外,在 Windows 平台存在另一个变体:若使用系统内置 Administrator 账号,Evergreen WebView2 初始化会因权限上下文失败,导致主界面完全无法打开。
对于 Linux 用户,请将 cc-switch 升级至 v3.13.0 或更高版本,该版本已系统性修复 UI 响应问题。
若暂时无法升级 Linux 版本,可尝试在启动时手动禁用合成模式:WEBKIT_DISABLE_COMPOSITING_MODE=1 ./cc-switch。
Linux 临时缓解方案:当界面卡死或白屏时,反复拖动调整窗口大小可强制触发 UI 重绘;也可尝试在设置中启用 Linux 原生标题栏。
对于 Windows 用户(主界面无法打开),若使用的是内置 Administrator 账号,请修改注册表开启 UAC 过滤后重启。
HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System FilterAdministratorToken = 1Windows 替代方案:通过环境变量指定固定版 WebView2 路径(例如 set WEBVIEW2_BROWSER_EXECUTABLE_FOLDER=<固定版WebView2目录>),或改用普通管理员账号登录。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 3 个真实 issue
- 为什么在 Ubuntu 24.04 上点击编辑文字界面就会卡住不动?
- 这是 WebKitGTK 渲染事件未正确触发导致的,请升级到 v3.13.0 及以上版本,官方已在此版本中修复。
- Windows 下托盘图标正常,但点击打开主界面没有任何反应怎么办?
- 如果你使用的是 Windows 内置 Administrator 账号,WebView2 会初始化失败。请修改注册表将 FilterAdministratorToken 设为 1 并重启,或新建普通管理员账号使用。
- Linux 下设置 WEBKIT_DISABLE_COMPOSITING_MODE=1 还是卡死怎么办?
- 可以尝试在 cc-switch 设置里面启用 Linux 原生标题栏,或者使用社区提供的 CLI 版本(cc-switch-cli)作为替代。
这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。