Atom代码片段需手动编辑snippets.cson文件，严格遵循CSON语法、正确scope匹配及执行重载命令才能生效；路径、命名、格式任一错误均导致失效。
Atom 编辑器没有独立的“自带代码片段管理器”界面或 GUI 工具——所有 snippet 管理都依赖手动编辑 snippets.cson 文件，配合 scope 匹配与重载机制生效。你无法在设置面板里点几下就增删改查，必须直面 CSON 语法和 grammar scope 规则。
snippets.cson 路径和格式必须严格正确
Atom 只读取唯一路径下的单个文件：~/.atom/snippets.cson（macOS/Linux）或 %USERPROFILE%\.atom\snippets.cson（Windows）。任何其他位置、名字拼错（比如 Snippets.cson）、大小写错误、扩展名用 .json 或 .yaml，都会被完全忽略。
- 文件内容必须是合法 CSON：键名不加引号，字符串含空格时用单引号（如
'source.js.jsx'），末尾不能有逗号 - 不要混入
init.coffee或keymap.cson的内容，它们互不感知 - 保存后必须执行
Ctrl+Shift+P→ 输入Snippets: Reload Snippets，重启 Atom 不必要，但不重载就永远不生效
scope 不匹配 = 片段隐身
snippet 是否出现，只取决于当前文件被 Atom 识别出的 grammar scope，而不是文件后缀名。你写的是 .jsx 文件，但 Atom 给它分配的 scope 是 source.js.jsx，那 '.source.js' 就完全无效。
- 查真实 scope：光标放文件里，
Ctrl+Shift+P→Editor: Log Cursor Scope，看输出链（如source.js.jsx meta.function.js） - scope 键要写成最具体且稳定的层级，比如
'.source.js.jsx'；跨类型用数组：['.source.js', '.source.js.jsx', '.source.tsx'] - 右下角显示
Plain Text？点击切换成对应语言（如JavaScript），否则 scope 根本不激活 - 别用
*当万能 fallback——短期调试可以，长期会拖慢补全响应
body 中的 $1/$2 必须结构合规才能跳转
$1、$2 不是装饰符号，而是 Atom 解析 body 后生成真实 tab stop 的依据。格式一错，光标就卡死或直接跳出编辑态。
-
body值必须缩进对齐body:，顶格写会被忽略 - 换行必须显式写
\n，不能靠回车；或者用三引号"""包裹整段多行内容 - 默认值写法是
${1:console.log}，不是$1="console.log"或${1:"console.log"} -
$0是退出位，不能当第一个焦点；${2:$1}可实现联动（比如函数名定义处改了，调用处自动同步）
真正卡住人的从来不是怎么写 body，而是 scope 查得不准、CSON 多了个逗号、重载没执行——这三点覆盖了 80% 以上失效场景。别急着改逻辑，先盯住右下角语言标识、Editor: Log Cursor Scope 输出、以及重载命令是否真执行了。
