snippet必须放在packages/user目录下才生效，windows路径为%appdata%\sublime text\packages\user\，macos为~/library/application support/sublime text/packages/user/，linux为~/.config/sublime-text/packages/user/；作用域应设为text.html，占位符$1和$0须置于内顶层文本流中，且需避免emmet劫持触发词。
Sublime Text 里写 HTML 骨架，别靠手敲 —— 正确配置的 snippet 一按 <code>Tab 就出来，光标还自动停在 <title></title> 里。但多数人卡在“输完 html5 没反应”，问题不在代码，而在路径、作用域或占位符写法。
Snippet 文件必须放在 Packages/User/ 目录下才生效
放错位置是失效第一大原因。Sublime 不扫描任意文件夹，只认固定路径下的 .sublime-snippet 文件：
- Windows：
%APPDATA%\Sublime Text\Packages\User\ - macOS：
~/Library/Application Support/Sublime Text/Packages/User/ - Linux：
~/.config/sublime-text/Packages/User/
别存到桌面、项目目录，也别放进 Packages/HTML/ 或 Packages/Emmet/ —— 那些是插件目录，Sublime 不加载里面的 snippet。确认路径后，文件名必须是纯英文+下划线，比如 html5.sublime-snippet，不能带空格或中文，也不能是 html5.snippet 或 html5.xml。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
<scope>text.html</scope> 是 HTML 文件触发的关键
作用域写错，snippet 就像不存在。常见错误包括：
- 用
source.html：Sublime Text 4 已弃用，基本不识别 - 用
text.html.basic：虽能生效，但可能被 Emmet 插件覆盖或拦截 - 漏写
<scope></scope>标签：默认只在 Plain text 下可用，HTML 文件里完全没反应
推荐写法：<scope>text.html</scope>。它覆盖所有 .html、.htm、.shtml 文件，且与 Emmet 兼容性好。如果想验证当前文件的实际作用域，按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Developer: Show Scope Name 回车，状态栏会显示类似 text.html 的字符串 —— 这就是你要对齐的 scope。
$1 和 $0 必须出现在 内部顶层文本流中
占位符失效不是因为语法错，而是位置不对。常见现象是输入 html5 + Tab 后，光标没跳进 <title></title>，反而把 $1 当普通字符输出了。
-
$1要直接写在之后、<code>]]>之前，不能嵌套在引号里、不能被其他标签包裹（比如<div>$1</div>可以，但"$1"不行） -
$0必须有且只能出现一次，代表最终光标停留点（比如放在
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
