atom自定义snippet必须放在~/.atom/snippets.cson（全局）或~/.atom/snippets/目录下.cson文件中；路径错则静默失效，修改后需执行snippets: reload snippets生效。
Snippet文件放在哪里才生效
Atom的自定义Snippet必须放在~/.atom/snippets.cson里，或者放在~/.atom/snippets/目录下的.cson文件中（推荐后者，便于分类管理）。直接新建一个my-react.cson放进去，Atom启动时会自动加载——但注意：改完文件后不需要重启Atom，按Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux）调出命令面板，执行Snippets: Reload Snippets即可立即生效。
- 路径错误是90%的“Snippet不触发”原因，尤其容易误放到项目根目录或
~/.atom/init.coffee里 -
snippets.cson是旧式单文件写法，结构易混乱；用snippets/子目录+多个.cson文件更清晰，比如js.cson、html.cson - 文件编码必须是UTF-8，BOM头会导致解析失败，Atom不会报错，但Snippet静默失效
语法格式必须严格匹配CSON规范
CSON是CoffeeScript风格的JSON，缩进敏感、冒号后要空格、字符串不用引号（除非含特殊字符）。写错一个空格或漏掉换行，整个Snippet块就无效。例如定义一个React函数组件：
'.source.js':
'React Function Component':
'prefix': 'rfc'
'body': """
const ${1:name} = () => {
return (
<div>
${2:// content}
</div>
)
}
export default ${1:name}
"""
-
'.source.js'是作用域标识符，不是文件扩展名——JSX文件也属于.source.js，TSX则要用.source.tsx -
prefix值不能含空格或大写字母，否则补全时不显示；rfc有效，React FC无效 -
body里的${1:name}表示第一个tab stop，${2:// content}是第二个；数字必须从1开始连续，跳号（如1→3）会导致后续占位符无法跳转
如何确认Snippet是否被正确加载
最可靠的方式不是靠记忆前缀，而是打开命令面板执行Snippets: Available Snippets（快捷键Cmd+Shift+P → 输入该命令），它会列出当前光标位置下所有可用Snippet及其作用域。如果没看到你的条目，说明：
- 作用域写错了，比如在JSX文件里写了
'.source.jsx'——Atom实际用的是.source.js（可通过Editor: Log Cursor Scope命令验证） - 文件未保存，或保存时用了中文路径/全角符号（CSON解析器会静默失败）
- 有语法错误，Atom不会提示，但会在开发者工具控制台抛出
Uncaught Error: Parse error on line X——按Cmd+Option+I打开DevTools看Console即可定位
作用域和语言包强相关，别硬套VS Code经验
Atom不靠文件后缀判断语言，而依赖已启用的语言包提供的scope。比如安装了language-babel，JSX文件的作用域才是.source.js；若只装了默认language-javascript，JSX可能被识别为.text.html.basic，导致Snippet完全不触发。
- 检查当前文件实际scope：光标置于编辑区，执行
Editor: Log Cursor Scope，看输出的第一行（如source.js） - 想让Snippet同时作用于JS和JSX？写成
'.source.js, .source.jsx'不行，得分别定义两个scope块，或统一用language-babel覆盖 - HTML模板里想用Vue指令Snippet？得匹配
.text.html.vue，而不是.source.vue——scope名称由对应语言包定义，不能猜
Snippets: Available Snippets和Editor: Log Cursor Scope这两个命令，比反复改代码高效得多。
