Atom自定义Emmet缩写需创建snippets.json文件并置于~/.atom/snippets.json（Windows为%USERPROFILE%.atom\snippets.json），按作用域（如"source.html"）定义键值对，用$1/$2控制跳转，修改后需重置语法模式生效；.jsx/.vue文件需在Emmet插件Extensions中映射jsx:html或显式添加对应scope。
Atom 本身不支持直接编辑 Emmet 的核心简写规则（比如改 html:5 的输出结构），但可以通过配置自定义缩写（snippets）实现等效效果——关键在于理解「哪里配、怎么配、配完为何不生效」。
如何添加自定义 HTML/CSS 缩写（snippets.json）
Emmet 在 Atom 中的自定义能力依赖于 snippets.json 文件，它允许你定义新缩写或覆盖默认行为。这个文件必须放在 Atom 配置目录下，路径为：~/.atom/snippets.json（macOS/Linux）或 %USERPROFILE%\.atom\snippets.json（Windows）。
- 首次使用需手动创建该文件（Atom 不会自动生成）
- 内容必须是合法 JSON，顶层是对象，每个 key 是作用域（如
"source.html"），value 是键值对：缩写名 → 展开内容 - 展开内容中用
$1、$2表示光标跳转位置，${1:default}可设默认值 - 修改后无需重启 Atom，但已打开的文件需重新触发语法模式（如切换到其他语法再切回 HTML）才生效
例如，在 snippets.json 中添加：
{
"source.html": {
"myheader": "<header class=\"site-header\">\n <h1>${1:Title}</h1>\n <p>${2:Subtitle}</p>\n</header>"
}
}
保存后，在 HTML 文件中输入 myheader + Tab，就会生成对应结构，并把光标停在第一个占位符上。
PigX UI 前端开发
下载
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
立即学习“前端免费学习笔记（深入）”；
为什么自定义缩写在 .jsx 或 .vue 文件里不生效
根本原因是 Emmet 默认只在 source.html、source.css 等原生语法作用域下加载 snippets.json 规则。.jsx 和 .vue 文件通常被识别为 source.js.jsx 或 source.vue，不在默认匹配范围内。
- 解决方法一：在
snippets.json中为对应语法显式声明，比如加上"source.js.jsx"或"source.vue"键 - 解决方法二：更推荐——通过 Emmet 插件设置里的
Extensions字段，把.jsx映射到html作用域（填jsx: html），这样它就自动继承source.html下的所有自定义缩写 - 注意：如果同时用了两种方式，优先级以
snippets.json中最具体的 scope 为准；但Extensions配置更轻量，适合复用现有 HTML 规则
常见失效场景与排查顺序
自定义缩写写完却没反应，90% 问题出在这几个环节，按顺序查比重装插件更快：
- 确认文件当前语法模式正确：右下角显示的是
HTML，不是Plain text或JavaScript—— 否则snippets.json根本不加载 - 检查
snippets.json路径是否准确，文件名不能带空格或扩展名（如snippets.json.txt） - 验证 JSON 格式：用在线工具（如 jsonlint.com）粘贴内容检查是否有逗号遗漏或引号不闭合
- 确认缩写名未与内置规则冲突：比如定义
"div"会导致原生div→<div></div>失效；应避免覆盖基础标签名 - 临时禁用其他可能劫持
Tab的插件（如autocomplete-plus的补全菜单弹出时会拦截）
真正难的不是写规则，而是让 Atom 精确知道「此刻该用哪套规则」——语法作用域、文件扩展名、插件配置三者必须对齐，缺一不可。一旦配通，一个 Tab 就能替代十几行手敲，但错一步就全程静音。
