HTML注释不支持快捷键提示，仅作人工记录；应紧贴JS事件绑定处用Meta+S等标准写法注明，推荐提取为常量并在shortcuts.js统一管理，避免HTML中冗余注释。
HTML 注释语法本身不支持快捷键提示
HTML 的 注释只是纯文本，浏览器和编辑器都不会从中解析出快捷键逻辑，也不会自动绑定或提示。所谓“给功能加快捷键注释”，实际是开发者在代码里**人工记录快捷键信息**，供自己或团队查阅——它不参与运行，只服务可维护性。
常见错误现象： 写了但没人看，或者写在 JS 逻辑外层，导致后期快捷键改了注释却没同步。
- 注释必须紧贴对应功能的实现位置（比如在
addEventListener('keydown', ...)上方） - 避免笼统描述，如
；应明确修饰符、键名、作用目标 - 如果快捷键由 JS 控制，注释放在 JS 里比 HTML 里更可靠
VS Code 中快速插入带快捷键说明的 HTML 注释模板
VS Code 支持自定义代码片段（snippets），可一键生成标准化注释行。编辑 html.json 片段文件，加入：
{
"Shortcut Comment": {
"prefix": "scmt",
"body": [""],
"description": "HTML comment for keyboard shortcut"
}
}使用时，在 HTML 文件中输入 scmt + Tab，即可展开为：，光标会停在 : 后方便补全功能名。
注意：不要把快捷键写死成 Ctrl —— Mac 用户用 Cmd，需根据部署环境或用户代理动态判断，注释里建议写成 Meta+S（Meta 是标准键名，覆盖 Cmd/Win）。
在 JavaScript 中同步维护快捷键注释与逻辑
真正起效的快捷键都在 JS 里注册，HTML 注释只是镜像。容易被忽略的是：JS 里监听 event.key 和 event.code 行为不同，注释若只写 S 可能误导。
-
event.key返回字符值（按 Shift+S 得"S"，小写 s 得"s"） -
event.code返回物理按键（Shift+S 和 s 都是"KeyS"） - 注释推荐按
event.code写，更稳定，例如：
实操建议：在绑定事件前加注释，并把快捷键字符串提取为常量，降低不一致风险：
// Meta+KeyS → submit form
const SUBMIT_SHORTCUT = { metaKey: true, code: 'KeyS' };
document.addEventListener('keydown', e => {
if (e.metaKey && e.code === 'KeyS') { /* ... */ }
});多人协作时快捷键注释的落地难点
最常被跳过的不是怎么写，而是「谁来更新」。快捷键一旦随新功能增加或冲突调整，HTML/JS 里的注释极易过期。
可行做法：
- 把所有快捷键收敛到一个
shortcuts.js模块，导出结构化配置，再由统一函数注册并生成文档注释 - CI 流程中加检查：扫描源码里
event.code出现的键名，对比注释中出现的键名，告警缺失项 - 禁止在 HTML 模板里写快捷键逻辑注释，只允许在 JS 层声明和注释
真实项目里，快捷键注释的价值不在“写出来”，而在“能被发现且可信”。一旦它开始和运行逻辑脱节，就变成了干扰信息。
