Atom代码片段仅加载唯一路径的snippets.cson文件：macOS/Linux为~/.atom/snippets.cson，Windows为%USERPROFILE%.atom\snippets.cson；必须严格使用CSON语法（键不加引号、缩进代替大括号、末尾无逗号），scope须精确匹配当前文件grammar scope（如source.js.jsx），body中$1/$0占位符需规范书写，修改后须执行Snippets: Reload Snippets生效。
snippets.cson 路径和格式错，片段就根本不会加载
Atom 只认 ~/.atom/snippets.cson（macOS/Linux）或 %USERPROFILE%\.atom\snippets.cson（Windows）这一固定路径下的单个文件。放错位置、改名成 snippets.json 或 my-snippets.cson，Atom 会直接忽略。
CSON 格式不是 JSON：键名不加引号，字符串值用单引号，嵌套靠缩进而非大括号，末尾不能有逗号。常见错误包括：
-
prefix: 'cl'写成"prefix": "cl"（双引号 + 冒号） -
body: 'console.log(\'$1\');'忘记转义单引号，变成body: 'console.log('$1');'（语法断裂） - body 多行内容没用单引号包裹，或缩进不一致导致解析失败
改完必须执行 Snippets: Reload Snippets（Cmd+Shift+P），重启 Atom 是低效替代方案。
scope 不匹配，片段“存在但不可见”
Atom 的 snippet 激活完全依赖当前光标所在位置的语法作用域（scope），不是文件扩展名。你写 '.source.js'，但文件实际被识别为 source.js.jsx，那 cl 就不会触发。
查 scope 的唯一可靠方式是：光标停在目标文件任意处 → Cmd+Shift+P → 输入 Editor: Log Cursor Scope → 看输出链，比如 source.js.jsx meta.function.js。
适配建议：
- 最具体 scope 优先：
'.source.js.jsx'比'.source.js'更准 - 跨类型支持用数组：
['.source.js', '.source.js.jsx', '.source.tsx']（注意逗号后空格） - 右下角语言标识必须是“JavaScript”，不是“Plain Text”——点它手动切换
body 中 tab stop 写法不对，光标跳转失效
$1、$2、$0 是真实可跳转焦点，不是占位符标签。写错就会卡住或跳过。
关键规则：
-
$0必须是最后一个跳转位，不能放在开头；$1必须存在，否则第一个 Tab 无响应 - 默认值写法是
${1:console.log}，不是$1:console.log - 多行 body 必须用单引号包裹，换行用
\n，例如：'const $1 = () => {\n return $2;\n}' - body 开头或结尾不能有多余空行，CSON 解析器会丢弃整段
项目级 snippets 需额外配置，全局文件不覆盖
想让某个 snippet 只在特定项目生效（比如只对 my-react-app 的 JSX 文件生效），不能只改 ~/.atom/snippets.cson。
正确做法：
- 在项目根目录新建
.snippets.cson（注意开头是点） - 内容结构和全局文件一致，但 scope 可更细粒度，例如
'.source.js.jsx text.html.basic' - 需安装
atom-ide-ui或启用project-plus插件才能自动加载项目级 snippets - 验证是否生效：Cmd+Shift+P →
Snippets: Available Snippets，看列表里有没有你的 prefix
scope 写宽泛（如 '*'）能临时绕过匹配问题，但会拖慢启动速度，且容易和其他 snippet 冲突——这不是权宜之计，是隐患源头。
