CopyQ macOS 故障排除：不可见的 GUI 和手动热键配置¶
本指南解决了 macOS（特别是 Apple Silicon M 系列设备）上遇到的常见问题，其中 CopyQ 图形界面 (GUI) 不出现，或者需要在不访问 GUI 的情况下重新分配全局快捷键（例如 F10）。
1. 不可见 GUI 故障排除¶
在 macOS 上，CopyQ 可以在后台正常运行，同时保持视觉隐藏，主要原因有两个：
离屏窗口坐标：分辨率更改或断开外部监视器后，CopyQ 可能会保留可见显示区域之外的坐标。
菜单栏凹口遮挡：在带有摄像头凹口的 MacBook 机型上，当托盘已满时，macOS 会自动隐藏凹口后面多余的菜单栏图标。
解决方案：重置几何和力显示¶
在终端中执行以下命令以清除屏幕外坐标并将窗口置于前台：
代码_块_0
如果窗口仍未出现，请通过 CLI 切换其状态：
代码_块_1
2. 使用 CudaText 手动更改热键¶
当全局快捷方式（例如“F10”）被其他应用程序声明或拦截时，可以使用 CudaText 在配置文件中直接编辑该快捷方式，而无需打开 CopyQ GUI。
步骤 1：终止 CopyQ 进程¶
CopyQ 必须在编辑配置文件之前停止，以防止它在终止时覆盖您的更改：
代码_块_2
步骤 2：在 CudaText 中打开配置¶
在 macOS 上，CopyQ 命令快捷方式存储在 copyq-commands.ini 中。
在 CudaText 中打开文件：
代码_块_3
注意：如果“Application Support”中不存在该文件，请打开 XDG 后备位置：
代码_块_4
第 3 步：重新分配快捷方式¶
1- 在 CudaText 中，按“Cmd + F”打开搜索栏。
2- 搜索“F10”或“GlobalShortcut=F10”。
3- 将“F10”替换为可用的快捷键（例如“F9”或“Ctrl+F10”或“Meta+F10”）。
4-保存文件（Cmd + S）并关闭 CudaText（Cmd + Q）。
步骤 4：重新启动 CopyQ¶
再次启动 CopyQ 以加载更新的快捷方式配置：
代码_块_5
新的全局快捷方式现在将处于活动状态。
（更新：8.9.’26 08:01 星期二）