scope字段必须填写Sublime内部语法作用域字符串（如source.python），而非文件后缀；需通过Developer: Show Scope Name命令获取真实scope，支持空格分隔多值表示“任一匹配”，且区分大小写。
Snippet 的 scope 字段到底写什么才生效
Sublime 的代码片段不会自动识别语言，必须靠 scope 显式声明适用范围，否则粘贴进去就“没反应”。这个字段不是填文件后缀，而是填 Sublime 内部的语法作用域（scope）字符串，比如 source.python 或 text.html.basic。
常见错误是直接写 python、html 或 .py——这些全无效。正确做法是：打开一个目标类型的文件（如 test.py），按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Developer: Show Scope Name 回车，光标所在位置会弹出真实 scope，复制最前面那段（通常带 source. 或 text. 前缀）。
-
scope值区分大小写，且支持空格分隔多个 scope，表示“满足任一即可”，例如source.python source.yaml - 如果想让片段在 Python 文件和 Jupyter Notebook（.ipynb）中都生效，得查出两者各自 scope 后并列填写，不能只写
source.python - 作用域层级越深匹配越精确，但太细（如加了
meta.function.python）会导致光标不在函数体内时失效
为什么 .sublime-snippet 文件放对位置也不起作用
路径没错，但 Sublime 加载 snippet 有隐含规则：只有放在 Packages/User/ 下，或对应语法包的 Packages/xxx/ 子目录里，且文件名以 .sublime-snippet 结尾，才会被识别。
容易踩的坑包括：Packages/User/snippets/ 这种自建子目录——Sublime 不递归扫描；或者把文件误存为 my_snippet.sublime-snippet.txt（Windows 隐藏扩展名导致）；又或者用中文命名、含空格，某些版本会静默忽略。
- 推荐统一放在
Packages/User/根目录，文件名用英文+下划线，如log_debug.sublime-snippet - 修改后无需重启 Sublime，但需确保当前文件已绑定正确语法（右下角显示 “Python” 而非 “Plain Text”）
- 如果仍不触发，打开 Sublime 控制台（
Ctrl+`），输入sublime.log_commands(True)，再试触发动作，看控制台是否打印 snippet 相关日志
scope 写对了，但只在部分上下文生效
Sublime 的 scope 匹配是“当前光标位置”的语法上下文，不是整个文件类型。比如在 Python 文件里写注释，光标落在 # 后面时，scope 实际是 comment.line.number-sign.python，而非 source.python。此时若 snippet 的 scope 只写了后者，就不会弹出。
解决思路是放宽 scope 条件，或明确覆盖常见子上下文：
- 常用组合写法：
source.python, source.python meta.function.python（覆盖函数体内） - HTML 中想同时支持
<script>和外部.js文件？得写source.js, text.html.basic source.js.embedded.html - 避免写过于宽泛的 scope（如
text），否则可能在 Markdown、纯文本里误触发，干扰写作
如何快速验证 snippet 是否被加载和匹配
别靠猜，用 Sublime 自带机制验证。先确认文件已保存在正确路径，再检查是否被解析：打开控制台（Ctrl+`），输入 view.settings().get('syntax') 看当前语法路径是否正常；再输入 view.scope_name(view.sel()[0].begin()) 获取光标处完整 scope 字符串。
如果 snippet 仍不出现，大概率是 scope 字符串没覆盖到当前实际 scope，或触发关键词（tabTrigger）拼错、含不可见字符。
- 检查
tabTrigger值是否含空格或特殊符号（只支持字母、数字、下划线、短横线） - 用
Ctrl+Shift+P→Insert Snippet手动调出列表，看你的 snippet 是否在其中（不在说明未加载） - 临时把
scope改成text测试——如果这时能触发，100% 是 scope 匹配问题
scope 匹配是 Sublime snippet 最隐蔽的故障点，它不像报错那样提示你哪里错了，而是安静地不响应。多查两次 Show Scope Name，比反复改 JSON 更省时间。
