Ctrl+/默认仅行注释，块注释需手动绑定editor:toggle-block-comment命令并配置对应语法scope的快捷键（如ctrl-alt-/），且依赖语言包是否定义blockComment规则。
Ctrl+/ 默认不支持块注释，得手动绑定 editor:toggle-block-comment
Atom 的 Ctrl+/（Windows/Linux）或 Cmd+/（macOS）默认只触发行注释，哪怕你选中多行，它也只是在每行开头加 // 或 #。想用 /* ... */ 或 '''...''' 这类包裹式块注释，必须显式调用 editor:toggle-block-comment 命令——这个命令默认没快捷键，也不随 grammar 自动启用。
常见错误现象：
– 选中一段 JS 代码按 Ctrl+/，结果每行都加了 //，不是 /* */
– 在 JSX 或 TSX 文件里按 Ctrl+Shift+/ 没反应（那是旧版插件逻辑，Atom 核心已不认）
– 查看 Keymap 设置里搜 toggle-block-comment，发现没任何绑定
- 打开 Atom → Config… → 点右下角 Open Config Folder
- 编辑
keymap.cson，加入类似以下内容（注意缩进是 2 空格，且用单引号）：
'.source.js, .source.jsx, .source.ts, .source.tsx': 'ctrl-alt-/': 'editor:toggle-block-comment'
别用 * 或 .text.plain 这类泛用选择器，否则可能在设置页或终端里误触发；scope 必须匹配当前文件真实 grammar（可用 Ctrl+Shift+P → Developer: Toggle Dev Tools → 控制台执行 atom.workspace.getActiveTextEditor().getGrammar().scopeName 确认）
不同语言的块注释行为差异很大，不能一概而论
块注释不是“统一插入符号”，而是由对应 language package 的 comment 配置项决定。比如：
- JS/TS：
/* */是标准块注释，但若 grammar 识别为.source.js.jsx（如 React 组件），部分老插件可能未定义blockComment，导致editor:toggle-block-comment静默失败 - Python：默认用三引号
'''...'''，但若当前文件被识别为.source.python.django或自定义后缀（如.pyi），可能 fallback 到行注释 - HTML：
editor:toggle-block-comment插入的是<!-- -->，不是/* */；JSON 文件默认不支持任何注释，除非装了language-json5
验证方式：临时新建一个 .js 文件，确认右下角显示 JavaScript，再试快捷键；如果仍无效，说明对应 grammar 没导出 blockComment 规则，需查该 language package 的源码或 issue。
DocBlockr 插件不处理块注释，别指望它自动补 /* */
很多人混淆 editor:toggle-block-comment 和 docblockr 的作用：
– docblockr 只在光标位于函数/方法声明行时，按 /** + Enter 自动生成 JSDoc 模板（如 /** @param {string} x */）
– 它不响应选中文本、不提供块包裹、不接管 Ctrl+/，更不会把任意选区包进 /* */
- 想对一段逻辑代码加块注释？必须用上文配置的
ctrl-alt-/或手动Ctrl+Shift+P→ 输入editor:toggle-block-comment执行 -
docblockr在.vue文件中默认不工作，因为<script></script>块 grammar 是text.html.vue，需手动映射到.source.js - 箭头函数、解构参数、TS 类型标注会干扰
docblockr解析参数名，但这和块注释完全无关
容易被忽略的兼容性坑：快捷键冲突与 grammar 识别失败
改完 keymap.cson 后快捷键仍不生效，大概率卡在这两个地方：
-
ctrl-alt-/在某些 Windows 键盘布局或远程桌面中会被系统截获（尤其带数字小键盘的机型），可换用ctrl-shift-/或alt-shift-/避开 - 文件后缀不标准（如
.jsx写成.js，或.ts被当成.text.plain），导致 scope 匹配失败——右下角状态栏显示什么，就写什么 scope - 多个插件（如
vim-mode-plus、atom-ide-ui）可能劫持快捷键，临时禁用它们再测试
最稳的验证方式：不依赖快捷键，直接 Ctrl+Shift+P → 输入 editor:toggle-block-comment → 回车执行。如果这时能正常包裹，说明问题纯属 keymap 配置或冲突；如果连命令都报错或无反应，那一定是 grammar 本身不支持块注释规则。
