<p>PhpStorm识别HTML中TODO需用<!-- TODO:全大写格式，冒号后必须有空格；须将文件所在目录设为Sources Root，并在Settings→Editor→TODO中启用HTML类型及对应正则模式。</p>
在 index.html 里写什么格式的注释才能被 PhpStorm 识别为 TODO
PhpStorm 默认只识别符合特定格式的行内注释，且必须带空格分隔。HTML 中只能用 <!-- --> 注释，所以正确写法是：
<!-- TODO: 修复导航栏响应式断点 --><!-- FIXME: script 标签位置导致 DOM 未就绪 --><!-- HACK: 临时绕过 Safari flex wrap bug -->
注意：TODO 必须全大写、紧跟 <!-- 后的空格，冒号后也必须有空格；小写 todo 或 // TODO 在 HTML 文件中不会被识别。
为什么在 index.html 里加了 TODO 却没出现在 PhpStorm 的 TODO 工具窗口
常见原因不是语法错，而是文件未被纳入索引范围或 TODO 模式未启用：
- 确认
index.html所在目录是项目源根（右键目录 → Mark Directory as → Sources Root） - 检查
Settings → Editor → TODO中是否勾选了 HTML 文件类型（默认可能只开 Java/JS） - 确保正则表达式模式包含
<!--\s*(TODO|FIXME|HACK)（默认配置通常已含，但自定义后易删掉） - 刚添加后需手动触发索引更新：菜单 File → Synchronize 或等待几秒自动刷新
如何快速跳转到 index.html 中所有 TODO 行
不用手动翻页，PhpStorm 提供两种高效路径：
立即学习“PHP免费学习笔记（深入）”；
- 快捷键
Alt+6（macOS 是Cmd+6）直接唤出 TODO 工具窗口，点击条目即可跳转到index.html对应行 - 在
index.html编辑器内按Ctrl+Shift+Alt+T（macOSCmd+Shift+Option+T），选择 Go to TODO 可循环定位当前文件内的下一条 - 工具窗口顶部可筛选 “Current File”，避免被其他文件的 TODO 干扰
注意：如果 index.html 是静态文件且不在 src 或 public 这类标准源根下，跳转可能失效——根源还是目录标记问题。
TODO 标记对 HTML 部署和浏览器运行有影响吗
没有。所有 <!-- --> 注释在 HTML 解析时被完全忽略，浏览器既不执行也不渲染，生产环境打包（如 Vite、Webpack）默认也不会移除它们。
- 但若用
html-minifier或类似工具压缩，需确认配置中removeComments: false，否则 TODO 注释会被清掉 - Git 提交时注释会保留，团队成员只要打开同一项目就能看到，无需额外配置
- 别把敏感信息写进 TODO 注释（比如
<!-- TODO: 替换硬编码的 API_KEY=abc123 -->），它会随 HTML 一起发布
真正容易被忽略的是：TODO 不是任务管理系统，它不会提醒、不会过期、不会关联 PR。标记了不等于解决了，得靠人去看、去清、去验证。
