Sublime无智能代码块注释，仅支持Ctrl+/逐行注释或Ctrl+Shift+/依赖语法定义的块注释；后者在JS中生效，在Python/HTML/Vue template中常因未定义blockComment而失效，根本取决于右下角语法名是否匹配且正确配置。

Sublime 里没有“智能识别代码块边界并自动注释”的功能，所谓“在代码块中插入注释”，实际只有两种可靠路径：用 Ctrl+/ 逐行加行注释，或用 Ctrl+Shift+/ 尝试包裹成块注释——但后者是否生效，完全取决于当前语法是否定义了 blockComment 规则。

为什么 Ctrl+/ 看起来像“块注释”但其实不是

它只是对选中的每一行开头机械添加或移除 //（JS/TS/C++）或 #（Python），不关心缩进、括号配对或逻辑结构：

• 未选中任何文本时：只处理光标所在整行，哪怕光标停在第 8 个字符位置
• 选中多行（含空行、缩进不一致的行）：每行都单独加/删行注释符，不会补大括号、if 或 end
• 在 Python 中选中缩进后的几行按 Ctrl+/，结果每行都加了 #，但缩进层级被破坏，直接导致 IndentationError
• 在 JSX 中只注释部分标签行，可能留下未闭合的
  ，ESLint 报 unclosed JSX tag

  Ctrl+Shift+/ 为什么经常没反应

  这个快捷键调用的是 toggle_block_comment 命令，但它不自带逻辑，只读取当前语法包里的 blockComment 配置（如 ["/*", "*/"]）。不支持的语言默认静默失效：

  

  阿贝智能

  一款面向儿童内容创作的AI平台，帮助用户制作儿童绘本、睡前故事和有声内容，将文字创意转化为完整的故事作品。

  下载

  • JavaScript 文件：选中后会生成 /* ... */，因为官方语法包定义了该规则
  • Python 文件：原生不支持 """ """ 块注释，Ctrl+Shift+/ 默认无响应（不是 bug，是设计如此）
  • HTML 文件：Ctrl+/ 插入 （整行包裹），但 Ctrl+Shift+/ 很可能没反应——多数 HTML 语法包没定义 blockComment
  • Vue / JSX 的 区域：通常不响应，因为语法 scope 没覆盖到，得靠插件或手动配置

  真正能控制注释行为的方式：改键绑定，而不是猜快捷键

  与其反复试 Ctrl+/ 和 Ctrl+Shift+/ 哪个有效，不如直接在用户键绑定里明确指定行为：

  • 想让 .env 或 .sh 文件强制走行注释（避免被 JS 语法包误判为 /* */）：
    

    [{"keys": ["ctrl+/"],"command":"toggle_comment","args": {"block": false},"context": [{"key":"selector","operator":"equal","operand":"source.shell, text.env"}]}]

  • 想让任意文件选中后都强制包裹（哪怕语法不支持）：
    {"keys": ["ctrl+alt+/"], "command": "toggle_comment", "args": {"block": true}}
  • 所有修改写在 Preferences → Key Bindings 右侧用户配置中，保存即生效，不用重启

  最常被忽略的一点：Sublime 的注释行为根本不由文件后缀决定，而由右下角显示的语法名（如 Python、JavaScript）实时驱动。新建未保存文件、冷门配置文件（.env、.toml）、或语法包损坏时，状态栏显示 Plain Text，这时所有注释快捷键都会静默失效——不是快捷键坏了，是 Sublime 根本不知道该用什么符号。