atom 的 ctrl+/ 仅支持行注释，多行选中时逐行添加//或#，不支持/.../块注释；需手动配置keymap绑定editor:toggle-block-comment并匹配正确grammar scope。
Ctrl+/ 只能行注释，多行选中后按它不会变块注释
Atom 的 Ctrl+/（macOS 是 Cmd+/）默认调用的是 editor:toggle-line-comments，行为固定：单行光标就注释/取消当前行；多行选中就对每行分别加/删行注释符（如 // 或 #），**不是包裹式块注释**。想把 5 行代码用 /* ... */ 包起来？这个快捷键做不到。
常见误操作：选中多行后狂按 Ctrl+/，结果每行都多了 //，还破坏了缩进对齐。
- 确认当前 grammar 是否生效：右下角看语言模式是否为
source.js、source.py等，不是Plain text - 检查是否被插件劫持：临时禁用
autocomplete-plus或vim-mode-plus，再试 - 别依赖“自动识别”，手动切 grammar 更稳：点右下角标签 → 选
JavaScript (Babel)而非仅JavaScript
要多行块注释，必须绑定 editor:toggle-block-comment
Atom 原生支持 editor:toggle-block-comment，但默认没快捷键。不配，就等于没有块注释功能。
打开配置文件：~/.atom/keymap.cson（macOS/Linux）或 %USERPROFILE%\.atom\keymap.cson（Windows），加入：
'.source.js, .source.jsx, .source.ts, .source.tsx, .source.python': 'ctrl-alt-/': 'editor:toggle-block-comment'
- 选择器必须匹配当前 grammar 的
scopeName：用Ctrl+Shift+P→Developer: Toggle Dev Tools→ 控制台执行atom.workspace.getActiveTextEditor().getGrammar().scopeName查真实值 - 别写
*或.text.plain这类泛用选择器，可能在设置页误触发 - 改完保存，无需重启，立即生效
块注释在 JSX / Vue / TypeScript 中容易静默失败
不是所有 grammar 都实现了 toggle-block-comment。比如 text.html.vue（.vue 文件默认 grammar）就不支持，按了 ctrl-alt-/ 没反应，也不报错。
- .vue 文件：进
Settings → Packages → Language Vue → Settings，把Scope Name改成source.js或source.ts - TypeScript：确保装了
language-typescript，且 grammar 识别为source.ts，不是source.js - 自定义后缀（如
.inc）：进对应 language package 设置页，手动加 scope 映射
验证方式：选中几行 → 按绑定的快捷键 → 看是否插入了 /* 和 */；没反应就回头查 grammar 和 keymap 选择器是否真匹配。
别指望 Atom 自动处理缩进和换行对齐
Atom 的注释逻辑只做“插入字符”，不做排版。比如你在缩进 4 空格的代码块里按 ctrl-alt-/，它会在行首插 /*，而不是自动缩进到内容起始列；块注释结束符 */ 也直接插在最后一行末尾，不管前面有没有空格。
- 手动对齐更可控：先用
Ctrl+Shift+A全选目标块 →Ctrl+Shift+I对齐缩进 → 再触发块注释 - Python 用户注意：如果
language-python没定义blockComment，ctrl-alt-/会回退到行注释，甚至插错位置 - 注释后建议立刻格式化：
Ctrl+Shift+P→ 输入Prettier: Format或对应命令，修复因注释引入的缩进断裂
真正容易被忽略的是：块注释不感知语义边界。选中含 if 语句和其花括号内三行，ctrl-alt-/ 会把整个区域包进去，但不会帮你补全缺失的 { 或校验语法——它只是文本操作，不是代码重构。
