点击任意输入框后，界面卡死 - cc-switch

Quick fix

设置环境变量 WEBKIT_DISABLE_COMPOSITING_MODE=1 或升级至 v3.14.1 开启原生标题栏，可修复 Linux 下的界面卡死与按钮无响应问题。

Symptom

报错原文复制

这个环境下，点击任意的输入框都会卡死，但点击仍然能感觉有按钮反馈（看鼠标图标的话），但视窗不会有任何变化

Cause

Tauri webview 在 Linux 上存在焦点获取与渲染问题。一方面，WebKitGTK 2.40+ 版本存在已知的渲染和输入缺陷，导致点击输入框后界面卡死；另一方面，GTK surface 的 input region 在窗口显示时未能重新协商，导致标题栏等窗口装饰区域失去焦点，无法响应鼠标事件。

Fix

1. 1

   在启动应用前设置环境变量以禁用 WebKitGTK 合成模式：export WEBKIT_DISABLE_COMPOSITING_MODE=1。如果无效，可尝试同时设置 export WEBKIT_DISABLE_DMABUF_RENDERER=1，或者将两者结合运行：WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 ./cc-switch。

2. 2

   针对标题栏按钮无法点击的问题，请升级到 v3.14.1，并在应用内开启“启用应用级窗口按钮”（原生标题栏选项）。

Affected Versions

Toolcc-switch

Version3.8.2 - 3.13.0 (受影响版本)，v3.14.1 修复了标题栏问题

PlatformsLinux

Source Issues

本页汇总自 2 个真实 issue

• #349linux下，点击任意输入框后，界面卡死
• #1814Linux 版本偶尔会出现标题栏按钮无法点击的问题

FAQ

设置环境变量后界面依然卡死怎么办？

可以尝试同时设置两个环境变量：WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 ./cc-switch。如果依然无效，建议暂时使用 cc-switch cli 版。

升级到 v3.13.0 后标题栏按钮依然无法点击？

v3.13.0 的修复并未彻底解决该问题。请升级到 v3.14.1，并在应用内开启“启用应用级窗口按钮”选项即可修复。

相关问题

config.toml 更改后不知不觉又回到之前的配置cc-switch 数据库是单一事实源，手动修改本地文件会被覆盖，需在软件内的 MCP 管理器或通用配置模块中统一修改。6 issues mergedWarmup request downgraded to model在 CC Switch 中关闭 Copilot 的 warmupDowngrade 选项，防止请求被静默替换为 gpt-5-mini。5 issues merged界面一片空白 cc-switch升级 cc-switch 到最新版本以默认禁用 DMABUF 渲染，或改用 CLI 版本解决 Tauri 2 兼容性导致的白屏问题。2 issues merged