gmux 常见问题

语言 · 中文 · English · 日本語

← 回到首页

配置改完按热键没反应？

  • 托盘 → 重新加载配置（或重启 gmux）。
  • 看托盘图标：变成红警告图标 = prefix 热键被别的应用占了；右键托盘 → 重试 prefix。
  • 托盘 → 设置 → 看是否有 TOML 解析错误，会显示行号 + 期望格式。

多显示器拔插后变体不切换？

gmux 会监听显示器变化（WM_DISPLAYCHANGE，去抖约 500 ms）：插拔显示器后自动重新枚举显示器并重新编译绑定，下次触发就会选中匹配新布局的 variant，无需手动重载。变化前已摆好的窗口不会自动重排，再按一次该绑定或 prefix+r 即可重新就位。

同型号两块屏怎么区分？

EDID 序列号自动区分。%APPDATA%\gmux\config.toml 里 [[display]] 的 id 字段格式 <model>@SN-<serial>，由 GUI 检测显示器时自动写入。

详细概念见 使用指南 → 显示器。

我的应用 gmux 找不到窗口怎么办？

去 设置 → 应用匹配 页修复，不用手写配置：

  1. 托盘 → 设置 → 侧边栏 应用匹配。
  2. 在列表里找到这个应用，点 「重新匹配」。gmux 会自动启动并采样它的窗口，提取稳定的匹配指纹（进程 / 窗口类 / 标题等）并写回配置，无需你提前手动打开应用。
  3. 如果它抓错了窗口、或采样不到稳定指纹，会弹出 「选择窗口」：从正在运行的窗口列表里手动指定哪一个才是这个应用，选中确认即可（这一步需要目标窗口已经开着）。

页面上每个应用会显示当前状态（「正在运行 · 认出 N 个窗口」/「当前未运行」）和「认窗口靠」哪些信号，平时不用管，只在摆放时抓错或找不到窗口才需要来点一下「重新匹配」。

终端类应用要注意：PowerShell / cmd / WSL 如果跑在 Windows Terminal 里，窗口实际归属 WindowsTerminal.exe。「选择窗口」弹窗里搜 terminal 或留空浏览，按每行底下显示的进程名挑对应的那一个。

配置能跨机器同步吗？

%APPDATA%\gmux\config.toml 是一份纯 TOML，可以丢进 git / Dropbox / OneDrive。

注意：display_profiles 里的 EDID 序列号是特定机器的，换机器要么重新跑「检测显示器」让 GUI 写入新机的 ID，要么提前给两台机器的对应屏取一致的 name 让 binding 配置可移植。

我能完全用键盘配置吗？

可以。config.toml 直接编辑就生效（重载即用）。GUI 是 alternative，不是必经路径。

还没找到答案？

GitHub Issues —— 功能建议、bug 报告、配置疑问统一走 Issues。