WebStorm中如何使用快捷键高效注释代码？

本文共计865个文字，预计阅读时间需要4分钟。

在WebStorm中，注释代码最可靠的方式有两种：

行注释用 Ctrl+/，不是 Ctrl+Shift+/

光标在任意位置，按 Ctrl+/ 就会为当前行加或删 //。选中多行也一样，每行单独处理。这个操作不会吞掉缩进，也不会在空行插入无意义的 //（WebStorm 默认跳过纯空行）。常见错误是误按 Ctrl+Shift+/ 想注释一行，结果弹出块注释模板，光标卡在中间，反而打断节奏。

• 如果当前行已有 //，再按一次 Ctrl+/ 会自动移除
• 光标在行首、行中、行尾效果一致，无需刻意定位
• 不支持对部分表达式（比如只注释函数参数列表）做行级注释——那是编辑器不支持的场景

块注释必须用 Ctrl+Shift+/，Ctrl+Alt+/ 是另一回事

Ctrl+Shift+/ 对选中代码包裹 /* ... */，且光标停在注释内容区首行，方便直接输入说明文字。而网上有些资料写的 Ctrl+Alt+/ 实际上是「添加文档注释」（JSDoc），只对函数、类、方法声明生效，按了没反应是因为光标不在合法位置。如果你在普通语句里按 Ctrl+Alt+/，大概率什么都不会发生。

• 选中文本后按 Ctrl+Shift+/，注释符号严格包裹所选范围，包括换行符
• 若选中内容跨多行但首尾不完整（比如只选中函数体中间一段），它仍会加块注释，但语义可能错乱
• JavaScript/TypeScript 中，/* ... */ 不会阻止语法检查，但会影响 ESLint 规则（如 no-unused-vars 可能失效）

Emmet 注释写法不适用于常规代码注释

有人尝试用 Emmet 语法比如 // 或 /*|*/ 再按 Tab 来生成注释，这在 WebStorm 里默认不生效。Emmet 主要用于 HTML/CSS 结构生成，对注释符号没有预设缩写。强行配置也不推荐：一是维护成本高，二是容易和真实标签缩写冲突（比如 // 在 Emmet 里实际代表「父级」操作符）。

• Emmet 的 ctrl+alt+/（某些旧版本）已被弃用，新版本不识别
• 想快速写 JSDoc 注释？把光标放在函数名上，按 /** 然后回车——这是 WebStorm 原生支持的触发方式，比记快捷键更稳
• 别在 JSX 或 Vue 模板里混用 Ctrl+/，它会按当前文件类型决定注释风格（JSX 用 {/* */}，Vue template 用 <!-- -->），这点容易被忽略

真正容易被忽略的是：注释快捷键的行为受文件类型和语言注入影响。比如在一个 .js 文件里，用 Ctrl+/ 注释掉一行 import，再用 Ctrl+Alt+O 优化导入时，这行注释会被当成“未使用代码”直接删掉——你得提前确认是否真要保留它。