当表示用户实际按下的物理按键或键盘操作序列时才该用 <kbd>，如 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R>；代码、命令、函数名等应使用 <code>，纯样式需求应用 CSS，避免语义错用。
什么时候该用 <kbd>，而不是 <code> 或 <span>
当你要表示「用户实际按下的物理按键」或「键盘操作序列」时，<kbd> 才是语义正确的选择。比如告诉用户“按
<kbd>Ctrl</kbd>+<code><kbd>Shift</kbd>+<code><kbd>R</kbd> 刷新”，这里不是代码片段，也不是普通文本，而是明确的输入动作。</p> <p>常见错误是把命令行指令（如 <code>git commit -m "msg"）或函数名（如
fetch()）套进 <kbd>——这会让屏幕阅读器误读为“按 k、b、d 键”，破坏可访问性。
-
<kbd>专用于真实按键：单键（<kbd>Enter</kbd>）、组合键（<kbd>Alt</kbd>+<code><kbd>F4</kbd>）、快捷键序列（<kbd>Cmd</kbd>+<code><kbd>Option</kbd>+<code><kbd>Esc</kbd>） -
<code>用于代码字面量、命令、文件名等，不表示击键行为 - 纯样式需求（比如想让文字变等宽）请用 CSS，别滥用语义标签
<kbd> 嵌套规则和浏览器默认表现
HTML 标准允许 <kbd> 嵌套，用来区分层级，比如修饰键 + 主键：<kbd><kbd>Ctrl</kbd><kbd>C</kbd>。主流浏览器会把外层 <kbd> 渲染成稍大边框，内层更紧凑，视觉上体现“组合”关系。
但注意：Chrome 和 Safari 对嵌套的默认样式支持较一致；Firefox 旧版本可能忽略内层样式，只渲染最外层。如果设计对齐要求高，建议加轻量 CSS 控制间距：
立即学习“前端免费学习笔记（深入）”；
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
kbd kbd { margin: 0 0.1em; }
- 不要用
<kbd>包裹整个命令行（如<kbd>npm install --save-dev eslint</kbd>），这是语义错用 - 修饰键（
Ctrl、Shift、Cmd）建议单独套一层<kbd>，再与主键组合 - 空格、加号、连字符等分隔符必须写在
<kbd>外，否则会被当成按键名（比如<kbd>Ctrl + V</kbd>会渲染出“空格键”）
无障碍（a11y）和 SEO 的实际影响
屏幕阅读器遇到 <kbd> 通常会读作“keyboard input”，并逐字读出内容。所以 <kbd>Ctrl</kbd> 会被读成“C T R”，而 <kbd><kbd>Ctrl</kbd><kbd>V</kbd> 可能读成“keyboard input Ctrl keyboard input V”——听起来生硬，但至少语义明确，比全用 <span> 强。
SEO 方面几乎无影响，搜索引擎不靠这个抓取关键词。重点在于：它让辅助技术用户清楚知道“这是要你动手按的，不是看的”。容易被忽略的一点是，如果你在文档里大量混用 <kbd> 和 <code> 表达相似内容（比如都写快捷键），反而会让依赖语音命令的用户难以准确触发操作。
- 避免在
<kbd>里放标点符号（如括号、引号），除非它是按键标识的一部分（如<kbd>(`)</kbd>） - Mac 系统的
Cmd键应写作<kbd>Cmd</kbd>，不是<kbd>⌘</kbd>（后者是图标，非文本，屏幕阅读器无法识别） - 涉及平台差异时（如 Windows 的
Ctrlvs Mac 的Cmd），用并列结构：<kbd>Ctrl</kbd> or <kbd>Cmd</kbd>，别塞进一个标签里
替代方案：什么情况下不该用 <kbd>
当描述的是「程序响应的输入事件」而非「用户按键动作」时，<kbd> 就不合适。比如讲 JavaScript 的 keydown 事件监听逻辑，或配置文件里写的 keymap 规则，这些属于系统内部处理流程，用户并不需要“按下去”，只是理解机制。
这时候更准确的是用 <code> 包裹事件名、属性名、配置项，比如 event.key、KeyboardEvent.code、"ctrl+k" 这类字符串值。
- 文档中解释“为什么
Ctrl+C在终端里没反应”，重点在信号处理逻辑，不用<kbd> - VS Code 的
keybindings.json里写的"key": "ctrl+shift+p"是配置值，应保持<code> - 教学场景里演示“按下后触发了哪个函数”，函数名（如
handlePaste()）永远用<code>，和按键本身区分开
<kbd> 前，多问一句：此刻用户真的需要把手放在键盘上吗？ 
