GistPad 不能自动同步 VSCode 代码片段，仅支持手动将 snippet 文件上传为 Gist 后编辑保存；它不监听 snippets 目录、不解析 JSON 结构、不自动加载，需配合 Settings Sync 才能实现全设备同步。
GistPad 不能直接同步 VSCode 的 user-snippets.json 或语言专属片段文件，它只是把 Gist 当作远程只读/可编辑的“文件夹”来用——你得手动把 snippet 文件上传为 Gist，再在 GistPad 里打开编辑，改完保存才真正更新到云端。
为什么 GistPad 不是“自动同步代码片段”的工具
GistPad 的核心能力是：把 GitHub Gist 当成一个轻量 Git 仓库，在 VSCode 里像本地文件一样打开、编辑、提交。但它不监听 snippets/ 目录变化，也不会自动把 log.code-snippets 这类文件推送到某个 Gist ID。
- 它不读取 VSCode 的用户片段配置路径（如
~/Library/Application Support/Code/User/snippets/） - 它不解析
.code-snippetsJSON 结构，也不生成补全前缀或占位符逻辑 - 你上传的必须是「已存在的 snippet 文件」，比如你自己导出的
react.code-snippets，GistPad 才能识别为可编辑文本
如何用 GistPad 管理代码片段（实操路径）
想让 GistPad 对代码片段起作用，得走“手动托管 + 编辑复用”路线：
- 先用
Preferences: Configure User Snippets创建或导出一个语言片段文件，例如typescript.code-snippets - 把这个文件单独上传为一个私有 Gist（用 Gist 插件或网页操作均可），记下 Gist ID
- 在 VSCode 中打开 GistPad，执行
GistPad: Open Gist，粘贴该 ID，即可在侧边栏看到并双击打开该文件 - 编辑后保存（
Cmd+S），GistPad 会自动 commit 并 push 到对应 Gist —— 此时内容已更新，但 VSCode 不会自动加载 - 要在新设备生效？必须手动把该 Gist 内容复制进本地
snippets/目录，或用Settings Sync扩展把整个snippets/文件夹纳入同步
容易踩的坑：命名、格式与加载失效
很多人以为只要 GistPad 里改了文件，VSCode 就会立刻识别新片段，结果触发不了补全。问题通常出在这几处：
-
prefix字段含空格或特殊字符（如"my log"），VSCode 只接受字母、数字、短横线、下划线；应写成"my-log" - 文件名和语言标识不匹配：Gist 里叫
utils.code-snippets，但内容里写的是"scope": "javascript"，而 VSCode 实际打开的是.ts文件 → 不生效 - JSON 格式错误未报错：少逗号、多逗号、单引号代替双引号，VSCode 会静默忽略整个文件，且不提示
- GistPad 编辑后没点右上角
✓ Commit按钮（仅保存文件 ≠ 提交变更），Gist 页面内容仍是旧版
真正省事的替代方案：Settings Sync + Gist
如果你要的是“改一处、全设备自动更新”，别绕弯用 GistPad 管理单个文件。直接用 Settings Sync 扩展，它会把整个 snippets/ 目录打包上传到一个私有 Gist，并在新设备下载后自动解压覆盖本地路径：
- 安装
Settings Sync后运行Sync: Upload Settings，它会自动包含所有*.code-snippets文件 - 新设备安装同款扩展，运行
Sync: Download Settings，重启 VSCode 即可全部加载 - 后续新增片段只需再上传一次，不用关心哪个文件对应哪个 Gist ID
真正的麻烦点不在“怎么传”，而在“怎么让 VSCode 认出并正确加载”——文件位置、命名、JSON 结构、语言 scope，四者缺一不可。GistPad 只解决“编辑”这一步，剩下三步还得自己盯紧。
