atom代码片段需手动创建snippets.cson文件于指定路径，严格遵循cson语法、精准scope匹配（如'.source.js'）、body用单引号转义特殊字符，修改后须执行snippets: reload snippets生效。
Atom 的代码片段（snippets）不是“开箱即用”的模板系统，它必须手动写进 snippets.cson 文件、严格遵循 CSON 语法、scope 精准匹配当前文件类型，否则根本不会触发——哪怕你 prefix 写得再顺手。
snippets.cson 文件放哪？路径错一个字符就失效
所有自定义 snippet 必须写在唯一路径下：
macOS/Linux：~/.atom/snippets.cson
Windows：%USERPROFILE%\.atom\snippets.cson
这个文件默认不存在，需手动创建。别放进 init.coffee、keymap.cson 或项目根目录下的任意 .cson 文件里——Atom 完全不读。
常见错误现象：
- 输入 log + Tab 没反应
- Snippets: Reload Snippets 后仍不生效
- Atom 启动时控制台静默跳过整个 snippets.cson
原因往往是：
- 路径漏了 .atom 前的点号（比如写成 atom/snippets.cson）
- 文件后缀用了 .json 或 .coffee
- Windows 下路径用了反斜杠但没转义（应统一用正斜杠或双反斜杠）
scope 怎么写才匹配 JS/TSX/HTML？别靠猜
snippet 是否触发，只看当前编辑器 grammar scope 和你写的 scope 是否完全一致。不能写 javascript，也不能写 source.js, source.tsx——CSON 不支持逗号分隔。
正确做法：
- 在目标文件中按 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Win/Linux），输入 Editor: Log Cursor Scope，回车，看底部状态栏输出（如 source.js.jsx）
- 常用 scope 值：'.source.js'（纯 JS）'.source.js.jsx'（React JSX）'.source.ts'（TypeScript）'.text.html.basic'（HTML）'.source.css'（CSS）
想跨多个语言生效？用数组：['.source.js', '.source.ts', '.source.js.jsx']
但注意：数组写法只在较新 Atom 版本中稳定，旧版建议拆成重复块。
body 里的换行、引号、占位符怎么写才不出错
CSON 对字符串和换行极其敏感。body 必须用单引号包裹，内部单引号要转义，换行必须显式写 \n，不能直接回车。
错误写法示例：body: console.log('$1'); $2 → 缺少外层单引号，解析失败body: 'console.log("$1");\n$2' → 双引号没问题，但若内容含单引号就得转义：'console.log(\'$1\');\n$2'body: '''console.log('$1');\n$2''' → 三重单引号适合多行，但首尾三个单引号必须顶格、无空格
占位符关键规则：
- $1 是第一个可跳转位置，$0 是最终光标退出点，别把 $0 放最前
- 默认值写法是 ${1:default}，不是 $1{default} 或 $1="default"
- 联动修改用 ${1:func} + ${1}，比如函数定义和调用同步变
改完为什么还是不生效？重载比重启更可靠
修改 snippets.cson 后，Atom 不会自动热重载。必须手动触发：
- Cmd+Shift+P / Ctrl+Shift+P → 输入 Snippets: Reload Snippets → 回车
- 或用快捷键：Cmd+Alt+Ctrl+L（Mac）、Ctrl+Shift+F5（Win/Linux）
比重启 Atom 更快、更安全，尤其当你开着多个项目 tab 时。重启虽也能生效，但容易因未保存其他文件导致意外丢失。
真正容易被忽略的是 scope 和 CSON 语法的耦合性：哪怕 body 写得完美，只要 scope 错一位（比如 .source.js 写成 source.js 少个点），整个块就彻底静默——连报错都不会有。
