跳转到内容

界面不会自动刷新,只有手动拖动窗口才会触发 UI 重绘 - cc-switch

Quick fix

升级至 v3.13.0+ 修复 Linux 界面卡死;Windows 内置管理员需修改注册表以正常显示主界面。

报错原文
界面不会自动刷新,只有手动拖动窗口才会触发 UI 重绘

该问题主要源于 Tauri 2 与 WebKitGTK 在部分 Linux 发行版(如 Debian 13、Ubuntu 24.04)上的渲染事件兼容性缺陷,导致点击输入框卡死或初始白屏。官方在 v3.13.0 中通过内置 WEBKIT_DISABLE_COMPOSITING_MODE=1 及引入焦点修复函数解决了此问题。此外,在 Windows 平台存在另一个变体:若使用系统内置 Administrator 账号,Evergreen WebView2 初始化会因权限上下文失败,导致主界面完全无法打开。

  1. 对于 Linux 用户,请将 cc-switch 升级至 v3.13.0 或更高版本,该版本已系统性修复 UI 响应问题。

  2. 若暂时无法升级 Linux 版本,可尝试在启动时手动禁用合成模式:WEBKIT_DISABLE_COMPOSITING_MODE=1 ./cc-switch。

  3. Linux 临时缓解方案:当界面卡死或白屏时,反复拖动调整窗口大小可强制触发 UI 重绘;也可尝试在设置中启用 Linux 原生标题栏。

  4. 对于 Windows 用户(主界面无法打开),若使用的是内置 Administrator 账号,请修改注册表开启 UAC 过滤后重启。

    HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System
    FilterAdministratorToken = 1
  5. Windows 替代方案:通过环境变量指定固定版 WebView2 路径(例如 set WEBVIEW2_BROWSER_EXECUTABLE_FOLDER=<固定版WebView2目录>),或改用普通管理员账号登录。

Toolcc-switch
Version3.11.1 - 3.15.0
PlatformsLinuxWindows
为什么在 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。本站不分发任何软件。