ctrl + / 用于行注释（添加/移除 //），ctrl + shift + / 用于块注释（添加/移除 / /），二者功能独立、不可互换；误用会导致嵌套注释或残留符号，取消块注释必须用 ctrl + shift + /，不能用 ctrl + /。
Ctrl + / 是行注释，Ctrl + Shift + / 是块注释，两者不能互换取消 —— 用错快捷键会导致注释嵌套或残留符号。
行注释快捷键 Ctrl + / 的实际行为
选中多行后按 Ctrl + /，IDEA 会在每行开头插入 //，包括空行；再次执行则逐行移除 //（哪怕该行原本没有注释）。
容易踩的坑：
- 如果某行已有 //，再按一次会变成 // //，取消时只删掉最外层，留下冗余
- 在缩进代码里使用，// 总是紧贴行首，不会对齐已有缩进（可手动调或启用 Settings > Editor > Code Style > Java > Comment > Line comment at first column 关闭）
- 不支持跨语言一致性：在 Python 文件里它插 #，但在 .sql 或 .yaml 中可能无效，需确认当前文件类型绑定的注释规则
块注释快捷键 Ctrl + Shift + / 的触发条件
必须先选中一段连续代码，然后按 Ctrl + Shift + / 才能包裹成 /* ... */。光标落在已存在的块注释内时，再按一次会直接移除整个注释边界 —— 不需要重新选中。
关键细节：
- 选区首尾若含换行符，IDEA 会把换行也纳入注释范围，可能导致格式错乱
- 若选中内容里已有 /* 或 */，IDEA 不会做语法校验，直接硬包，结果可能是非法嵌套（如 /* /* inner */ */）
- 在 JavaScript 中，/* ... */ 可跨行，但不支持在注释内写 */，否则提前截断；Java 同理，但 IDEA 默认会自动转义（不推荐依赖）
为什么不能用 Ctrl + / 取消块注释？
Ctrl + / 只识别 //、# 等行首标记，对 /* 和 */ 视而不见。如果误用它去“取消”块注释，只会给每行加 //，变成混合注释：
// // /* 这段代码被注释了 */ // */正确做法始终是： - 块注释只能用
Ctrl + Shift + / 开关
- 行注释只能用 Ctrl + / 开关
- 混合存在时，先删块注释再处理行注释，顺序反了容易漏删快捷键失效时优先检查这三处
不是所有项目都默认启用这些快捷键：
- File > Settings > Keymap 中搜索 Comment with Line Comment 和 Comment with Block Comment，确认绑定未被覆盖（尤其装了 Vim 插件后常被重映射）
- 当前编辑器右下角显示的文件类型是否为 IDE 识别的源码类型（如显示 Text 而非 Java，快捷键会静默失效）
- 有无启用 Settings > Editor > General > Smart Keys > Add block comment on <code>Ctrl + Shift + / —— 这个开关控制的是“是否允许在无选区时自动包裹当前行”，关闭后必须手动选中才生效
真正麻烦的不是记不住快捷键，而是当块注释和行注释混在一起时，IDEA 不会高亮提示嵌套风险，得靠人眼扫 —— 尤其在折叠代码块后，很容易漏掉中间藏了个 /*。
