Sublime Text中用Ctrl+Shift+/（Win/Linux）或Cmd+Shift+/（macOS）可对完整HTML/XML节点智能包裹注释，需确保语法为HTML/XML且选区为完整标签；Ctrl+/仅作行注释，会导致HTML结构错乱。

用 Ctrl+Shift+/（Windows/Linux）或 Cmd+Shift+/（macOS）触发结构化注释

Sublime Text 默认支持对 HTML/XML 节点做「包裹式注释」，前提是光标位于标签内或选中了完整节点（包括开始标签、内容、结束标签）。这个快捷键不是简单加 ，而是智能识别节点层级，自动补全起止注释标记，并保留缩进结构。

常见错误现象：只选中标签名、或只选中部分内容，会导致注释错位甚至破坏结构；未安装或禁用了 HTML 语法高亮时，快捷键可能无响应。

• 确保当前文件语法为 HTML 或 XML（右下角状态栏显示，可点击切换）
• 选中范围必须是「语法上完整的节点」：比如 ...，不能只选
• 若光标在标签内部（如

  |Hello

  ），不选中任何文本，快捷键会自动包裹整个
  节点
• 嵌套节点也能处理，例如选中
  • A
  ，结果是 ，但注意：它不会递归注释子节点里的注释——只是单层包裹

为什么 Ctrl+/ 不适用于 HTML 结构化注释？

Ctrl+/ 是 Sublime 的通用行注释快捷键，在 HTML 中只会给每行开头加 ，导致严重错乱。比如对三行内容使用，会生成：

这根本不是合法注释，浏览器会解析出可见的 区域）。如果需要折叠能力，推荐安装插件 Tag（通过 Package Control 安装），它能识别 HTML 注释并启用代码折叠。

• 安装后重启 Sublime，打开 HTML 文件，将光标放在 这类条件注释
• 不要装 Comment-Snippets 来解决结构化问题——它只提供注释模板片段，不改变注释行为逻辑

XML 场景下要注意命名空间和自闭合标签

XML 比 HTML 更严格，Sublime 的结构化注释在 XML 中同样生效，但需注意两个边界情况：

• 带命名空间的标签（如 ）会被正常包裹，但注释后若手动编辑，容易漏掉冒号前缀，导致 XML 解析失败
• 自闭合标签（如 或 ）选中整行使用快捷键，结果是 ，合法；但如果文件语法被误设为 Plain Text，则可能只注释到 /> 前，留下悬空 />
• XML 不允许注释中嵌套 --，所以如果节点内容本身含双连字符（如 ），直接包裹会导致语法错误——此时必须手动拆分或改用 CDATA

实际用的时候，最常被忽略的是语法模式是否正确，以及选区是否真正“完整”。一旦光标位置或选区偏差一两个字符，注释就可能切在标签中间，后续调试会花更多时间修复。

# css  # xml  # 命名空间  # if  # win  # macos  # ai  # mac  # 浏览器  # windows  # svg  # js  # sublime  # html  # linux  # 递归