vscode支持f13–f24键直接绑定，需在keybindings.json中写"key":"f13"（小写、无修饰符）、"command":"editor.action.formatdocument"，并配精确when条件如"editortextfocus && editorhasdocumentformattingprovider"，配合qmk/zmk固件发送标准f13–f24键码实现物理层上下文联动。
直接用 QMK/ZMK 固件层 + VSCode keybindings.json 联动，比单纯改快捷键效率高一个量级——关键不是“映射键”，而是让键盘物理层切换自动带入对应上下文，避免手离开主键区、眼睛离开代码。
怎么让机械键盘的 Fn 层触发 VSCode 命令
QMK 或 ZMK 的 keymap 中，不要把“格式化文档”硬编码成 Ctrl+Shift+F 这类组合键；而是用 KC_APP（Application 字符）、KC_F13~KC_F24 或自定义 Consumer Key（如 CK_BOOT）发送非标准键码。VSCode 能识别这些键，且不会被系统拦截。
- 推荐用
F13~F24：Windows/macOS/Linux 全平台可用，无冲突，且keybindings.json中可直接写"f13" - 避免用
MediaPlay等通用媒体键：部分系统或播放器会劫持，VSCode 收不到 - 在 QMK 的
keymap.c里，给某键绑定XXXXXX（自定义 keycode）后，需在quantum/keycodes.h中声明，否则固件编译不通过
VSCode 里怎么绑定 F13–F24 这类键
keybindings.json 支持所有标准键名，包括 f13 到 f24，大小写敏感，不加引号外的修饰前缀（比如不能写 "ctrl+f13"，那是两个键）。
- 正确写法：
"key": "f13"，对应命令"editor.action.formatDocument" - 错误写法：
"key": "F13"（大写不识别）、"key": "f13 f14"（空格是“和”逻辑，不是序列） - 必须配
when：比如格式化只在编辑器中生效，就加"when": "editorTextFocus && editorHasDocumentFormattingProvider"，否则按了没反应 - Mac 用户注意：
cmd是 macOS 专属修饰键，f13在 Mac 上默认被系统保留，需在系统偏好设置 → 键盘 → 快捷键 → “Mission Control” 里关掉F13的绑定
为什么不用 Hyper 键模拟 Ctrl+Shift+P
Hyper 键（Caps Lock 改成 Modifier）看似方便，但实际踩坑多：VSCode 对多层修饰键解析不稳定，尤其在远程开发（SSH/Dev Containers）或 Wayland 环境下，hyper+p 经常变成 ctrl+p 或直接丢键。
- 真实问题：
when条件失效——VSCode 有时收不到完整的修饰键状态，导致editorTextFocus判断为 false - 调试困难：打开
Developer: Toggle Developer Tools→ Console，执行monaco.keybinding.keyboardLayoutService.getKeyboardLayout()可查当前键码，但 Hyper 键常显示为ctrl单独触发 - 更稳方案：用物理层切换（比如
SpaceFN按住空格进命令层），再配合单键f13~f24，VSCode 收到的是干净键事件，when判断 100% 可靠
容易被忽略的跨设备同步细节
keybindings.json 本身不带平台判断，但你的机械键盘固件可能在 Windows 和 macOS 下发送不同 keycode（比如 QMK 的 #ifdef OS_DETECTION 分支），这时 VSCode 配置必须对齐。
- 别在
keybindings.json里写"mac": true分支——VSCode 不支持这种语法，那是settings.json的写法 - 真正做法：用两套固件配置（win.json / mac.json），或统一用
F13~F24这类跨平台键，它们在所有系统里 keycode 一致 - 同步时只同步
keybindings.json，别同步固件源码——不同人键盘布局不同，固件应本地编译 - 测试要点：换设备后，先按
F13，打开命令面板输Developer: Toggle Keyboard Mapper，看是否记录到f13事件，再验证命令是否执行
最麻烦的从来不是写几行 JSON，而是固件层发的键 VSCode 能不能稳定收到、上下文条件能不能准确判断——建议每次新增一层，先用 Developer: Toggle Keyboard Mapper 实时看键码和 when 结果，再绑命令。
