Mac外接机械键盘单键双输是轴体物理抖动被macOS直接捕获所致，需用Unshaky软件层延迟过滤；支持单键独立调参，启用“Ignore external keyboards”开关避免误加延迟，或通过品牌驱动更新固件去抖，同时禁用macOS重音长按机制。
Mac外接机械键盘按一次键却输出两个相同字符（如“a”变“aa”），不是系统重复速率问题，而是轴体物理抖动信号被macOS直接捕获并重复注册——必须用软件层延迟过滤，绕过系统级输入链路。
用Unshaky精准拦截单个抖动按键
这是目前唯一能区分外接键盘与内置键盘、且支持单键独立调参的macOS原生方案，无需重启、不改系统设置，启动即生效。
方法一：安装并启用基础防抖
打开浏览器访问 unshaky.app 官网 → 点击首页“Download”按钮下载最新版Unshaky.dmg → 双击挂载镜像 → 将Unshaky拖入“应用程序”文件夹 → 双击启动。
首次运行会弹出“是否允许辅助功能”，点“好” → 系统设置自动跳转至“辅助功能→指针控制→辅助键盘”，勾选Unshaky并输入管理员密码解锁 → 返回Unshaky主界面，点击左下角“+”号添加问题按键（如空格、T、R）。
在对应按键右侧输入延迟值，【建议从35ms开始试，高于45ms可能让快速连打断节奏】 → 点击“Apply”立即生效。
方法二：启用“忽略外部键盘”实验功能（关键）
在Unshaky主界面右上角点击齿轮图标进入高级设置 → 找到“Ignore external keyboards”选项并开启 → 该功能会自动跳过所有USB/蓝牙外接键盘的防抖处理，只作用于MacBook内置键盘。
⚠️ 注意：此开关必须打开，否则你正在调试的外接机械键盘会被误加延迟，反而导致响应迟滞。
通过键盘固件层全局去抖（仅限支持热更新的品牌）
如果你的外接机械键盘品牌配套驱动支持固件级去抖参数（如Keychron V4/V5、Akko 3068B、Royal Kludge RK84/RK96等），优先走这条路径——它比软件层更底层、零延迟、不依赖macOS权限。
第一步：确认键盘型号是否在官方驱动支持列表内，打开对应品牌驱动软件（如Keychron QMK Toolbox、Akko Cloud Driver）。
第二步：进入“Advanced Settings”或“Firmware Config” → 找到“Debounce Time”或“Chatter Elimination”开关并启用。
第三步：将按下去抖设为5ms，抬起去抖设为3ms；若用于文字录入稳定优先，可保守设为8ms/5ms；若测试后仍有双击，再逐步下调，每次只减1ms。
第四步：点击“Save & Flash”写入固件 → 键盘自动重启 → 打开 keyboardtester.com 实时敲击验证，观察波形是否由双峰变单峰。
禁用macOS重音长按机制（排除误触发干扰）
外接机械键盘触发行程短、回弹快，macOS默认开启的“长按呼出重音菜单”功能会把轻微抖动误判为长按，反复弹出à/á/â选择框，造成“按一下触发两次”的错觉。这本质不是连击，而是UI层干扰。
打开“访达” → “应用程序” → “实用工具” → “终端”；
粘贴并执行命令：defaults write NSGlobalDomain ApplePressAndHoldEnabled -bool false；
【必须退出当前用户会话】：点击右上角苹果图标 → “退出登录”，再重新输入密码登录；
验证：长按任意字母键（如e），应直接连续输出“eeeeee”，不再弹出重音选项框。
