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 中只注释部分标签行，可能留下未闭合的
<div>，ESLint 报 <code>unclosed JSX tagCtrl+Shift+/为什么经常没反应这个快捷键调用的是
toggle_block_comment命令，但它不自带逻辑，只读取当前语法包里的blockComment配置（如["/*", "*/"]）。不支持的语言默认静默失效：- JavaScript 文件：选中后会生成
/* ... */，因为官方语法包定义了该规则 - Python 文件：原生不支持
""" """块注释，Ctrl+Shift+/默认无响应（不是 bug，是设计如此） - HTML 文件：
Ctrl+/插入<!-- -->（整行包裹），但Ctrl+Shift+/很可能没反应——多数 HTML 语法包没定义blockComment - Vue / JSX 的
<template></template>区域：通常不响应，因为语法 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 根本不知道该用什么符号。 - JavaScript 文件：选中后会生成
