<p>HTML中Ctrl+/仅在选中完整标签时包裹为<!-- -->，未选中或跨语言块时失效；需确认文件类型为HTML、避免光标在JS/PHP块内，并用Ctrl+W智能扩选确保结构完整。</p>
HTML里用 Ctrl+/ 会出错，别硬套
Ctrl+/ 在 HTML 文件里不会加 <!-- -->，而是强行插 //——浏览器直接报错或忽略。这不是 PhpStorm 的 bug，是它按语言类型自动匹配注释语法：HTML 没有行注释，但 PhpStorm 默认仍走 JS/PHP 那套逻辑，结果就是错的。
常见错误现象：<div>// <p>Hello</p></div> 这种代码被当成文本渲染，而不是被注释掉。
- 必须先确认当前文件类型识别正确：右下角看是否显示
HTML，不是Text或Plain Text - 如果显示不对，右键文件 →
Override File Type→ 选HTML - 确保光标在 HTML 编辑区（不是在 JS 块或
<script>标签内）
真正能注释 HTML 的快捷键是 Ctrl+/，但得先选中
这个操作本质是“包裹注释”，不是“加行注释”。只要选中一段完整 HTML（哪怕跨多行、含嵌套标签），按 Ctrl+/（macOS 是 Cmd+/）就会自动套上 <!-- -->，且不破坏结构。
示例：选中以下三行再按 Ctrl+/
立即学习“PHP免费学习笔记（深入）”；
<header> <h1>Title</h1> </header>
结果变成：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
<!-- <header> <h1>Title</h1> </header> -->
- 没选中任何内容时按
Ctrl+/，只对光标所在行生效，且可能只包住半截标签（比如只包住<div>不包</div>） - 如果选区开头或结尾落在标签中间（如从
<p>Hello中间开始），注释会不闭合或错位 - 已存在
<!--或-->的行，再按一次Ctrl+/会自动移除整个注释块，不是叠加嵌套
想注释 JS 或 PHP 代码块？用 Ctrl+Shift+/
在 HTML 文件里混写 <script> 或 <?php ?> 时，Ctrl+/ 会失效或行为异常——因为 PhpStorm 切换到了对应语言上下文。这时该用 Ctrl+Shift+/（macOS 是 Cmd+Shift+/）。
它会用 /* */ 包裹选中内容，保留缩进和换行，适合注释多行 JS 或 PHP 逻辑。
-
Ctrl+Shift+/对纯 HTML 标签无效（会加/* */，但浏览器不认） - 如果选中区域横跨 HTML 和 JS（比如
<script>console.log(1);</script>），建议分段操作 - 注意：PHP 块里用
Ctrl+/仍有效（加//），但只适用于单行；多行必须用Ctrl+Shift+/
批量注释大段模板时，先用 Ctrl+W 扩展选区
手动拖选几十行容易漏或错位，Ctrl+W（macOS 是 Cmd+W）能智能扩选：光标停在某个标签内，按一次选中标签内容，再按一次选中整个标签对（包括开闭标签），第三次选中父容器……直到覆盖整块模板。
配合 Ctrl+/ 就能零失误注释一个组件或区块。
- 扩选过程中如果跳过了想注释的部分，按
Esc退出再重来 - 扩选后检查状态栏是否显示“x lines selected”，避免只选中了文本节点而漏掉标签
- 扩选 + 注释后，若发现结构异常（比如
<!-- <div>... -->少了闭合），说明扩选没到位，重新Ctrl+W再试
实际项目里最容易被忽略的点：HTML 注释不是“开关式”操作，它依赖选区完整性。光标位置、语言模式识别、标签边界对齐，三者缺一不可。别指望一键全文件注释，老老实实选、再按、再验。
