如何在_Fitten_Code_中配置个性化代码片段（Snippets）库

在 Fitten Code 里配置一套自己的代码片段库，说到底就是图个顺手——那些高频出现的代码块、项目特有的语法结构，不用再一遍遍手动去敲复制粘贴。不过先泼盆冷水：版本得跟上，至少要 v1.8.0 以上才支持这个功能。操作路径不算复杂，核心就是新建一个 `.snippets.json` 结尾的文件，按规范写 JSON 格式的片段主体，加上 `prefix`、`body`、`description` 三个字段，最后保存、重启标签页，输入前缀按 Tab 验证是否生效。流程走对了，这套“私人快捷键”才能真正跑起来。

先确认一下：你当前装的 Fitten Code 版本是不是足够新。如果低于 v1.8.0，那用户级 snippets 功能是看不到的，后面再怎么折腾也白搭。版本到位之后，就可以走下面的“四步创建法”了。

创建用户级 Snippets 文件

操作其实很直接：打开 Fitten Code，点击左下角的那个小齿轮，找到「配置用户代码片段」选项，在弹出的列表里选「新建代码片段文件」，输入一个名字（比如

），然后回车。编辑器会自动帮你生成一个空文件，并把它放到 Fitten Code 的用户 snippets 目录下。这里有个小坑：手动创建的话，文件名后缀必须是 ，不能是 .json 也不行 .snippet，写错了编辑器就直接忽略了。

编写符合规范的 Snippet JSON 内容

打开刚才建好的文件，直接开始写标准 JSON 结构就行。最外层是一个对象，每个代码片段对应一个键值对。键名就是你设定的触发词（比如

），值对象需要包含三个字段：（触发前缀）、（要插入的代码内容）、（提示文字）。

举个例子，一个控制台输出的片段可以写成：
"clog": {
"prefix": "clog",
"body": ["console.log('$1');", "$2"],
"description": "插入 console.log 并定位光标"

这里有几个细节需要注意：

，每个元素代表一行代码；，$1 是第一个停靠点，输完内容按 Tab 跳到 $2。Fitten Code 目前只支持 $0、$1、$2 这三个占位符，写成 $3 或更多是无效的。另外，引号别漏掉，否则整个 JSON 都会报错。

设置语言作用域限制

想让片段只在特定语言里生效，有两种办法。第一种：在 snippet 对象里加一个

字段，值填语言 ID 字符串，比如 或 。第二种：直接把 snippets 文件命名为 ，比如 ，编辑器会自动把它绑定到对应语言，不用再写 scope 字段。这两种方式如果冲突，以文件名绑定为准。

如果什么都没指定，那这个片段就全局有效——听起来方便，但实际用起来可能会有意外触发，比如在写 Python 的时候突然冒出一个 React 的片段。所以建议还是按项目或语言做一下隔离，不然后面自己都容易搞混。

启用并验证 Snippet 生效

文件写好了，怎么知道它有没有被正确加载？走三步：
第一步：保存刚才编辑的 snippets 文件（快捷键 Ctrl+S 或 Cmd+S）。
第二步：关闭当前编辑器标签页，再重新打开一个同语言的标签页——这一步不能省，直接刷新标签页没用。
第三步：在编辑区输入你设定的 prefix（比如

），然后按 Tab 或回车，看看能不能正确展开，并且第一个占位符是不是自动被高亮选中。

如果完全没反应，别急，按下面几个方向排查：文件有没有放到用户 snippets 目录（注意不是工作区下的

目录）；JSON 有没有语法错误——Fitten Code 不会提示你哪里错了，它只是默默地忽略掉整个文件；输入的 prefix 是不是跟其他已存在的片段冲突了，如果冲突，后加载的那个会覆盖前面的。前两个问题最常见，检查一下基本都能搞定。