atom不支持嵌套注释，其注释命令仅为单层文本包裹操作，无法识别已有注释块；安全做法是选中区域后用ctrl+/批量切换为行注释，恢复时再统一取消。
Atom 对嵌套注释本身不提供原生支持
Atom 编辑器的 editor:toggle-block-comment 和 editor:toggle-line-comments 都是“单层”操作逻辑，不会识别或处理已存在的注释块内部是否还能再嵌套。比如在 JavaScript 的 /* ... */ 块里再按一次 ctrl-alt-/，它只会尝试在外层再包一层 /* 和 */，结果变成 /* /* inner */ */——这在 JS 中是语法错误，浏览器会直接报 Invalid or unexpected token。
这不是 Atom 的 bug，而是所有主流编辑器（VS Code、Sublime）的通用限制：注释切换是文本层面的包裹/剥离，不是 AST 感知的语义操作。
- 语言插件（如
language-javascript）只定义了/* */和//的起始/结束模式，不解析嵌套合法性 - Tree-sitter 语法解析器（Atom 1.59+ 默认启用）仍不介入注释嵌套校验，仅用于高亮和折叠
- 如果你真需要嵌套注释能力，得靠外部工具（如 ESLint +
no-unexpected-multiline规则提前拦截）
怎么安全地模拟“嵌套注释”效果
实际开发中所谓“嵌套”，多数是想临时屏蔽一段含已有注释的代码块。正确做法不是硬套多层 /* */，而是用行注释批量覆盖：
- 选中目标区域（含内部已有
/* */块），按ctrl+/→ 全部转成//行注释 - 若当前 grammar 不支持行注释（如某些 DSL），先手动切到
Plain Text或HTML再执行，避免触发块注释逻辑 - 恢复时再次选中，再按
ctrl+/，Atom 会智能移除所有//（即使混着/* */） - 注意：JSX/TSX 文件中，
ctrl+/在标签内可能插入{/* */}，这是预期行为，不是错误
为什么 ctrl-alt-/ 在 JSX/TSX 里经常静默失败
这是因为 language-jsx 和 language-typescript 的 grammar scope 不一定包含 editor:toggle-block-comment 的绑定路径。常见现象是按键后无反应、无报错、光标也不动。
- 打开 DevTools（
ctrl-shift-p→Developer: Toggle Dev Tools），执行atom.workspace.getActiveTextEditor().getGrammar().scopeName，确认输出是source.jsx而非text.html.basic - 检查
keymap.cson是否漏掉了对应 scope：'.source.jsx, .source.tsx'必须显式列出，不能只写'.source.js' - 某些 Babel 插件（如
language-babel）会覆盖默认 grammar，导致toggle-block-comment未注册；此时建议换用官方language-javascript+language-jsx - 如果只是临时需要，可直接输入
{/*+ 回车 +*/}，Atom 的自动补全会帮你闭合（前提是启用了autocomplete-plus）
真正容易被忽略的点：注释操作受缩进和空行干扰
Atom 的注释逻辑对物理行结构敏感。以下情况会导致意外行为：
- 选区末尾带空行？
ctrl+/可能给空行也加//，后续取消时会多删一行 - 代码行首有空格或制表符？部分 language package 会把注释符插在缩进后而非绝对行首，造成视觉错位
- 在 Vue 单文件组件的
<script setup></script>区域，若 grammar 识别为source.vue而非source.js，ctrl-alt-/绑定完全不生效 - 最稳妥的做法：执行前先按
ctrl-alt-l（editor:consolidate-selections）清理选区，再操作
