在Sublime Text中设置代码片段的scope可精确控制其触发范围。通过<scope>标签指定语法类型，如source.js用于JavaScript文件，text.html.basic用于HTML文件。使用Ctrl+Alt+P快捷键查看当前光标位置的实际scope，确保配置准确。例如，为Vue文件设置text.html.vue scope可使片段仅在.vue文件中生效。不同语言对应不同scope，建议针对特定语法包实际查看并配置，避免使用过宽泛的scope如source。保存后重启Sublime或重新加载语法包使更改生效，从而提升代码补全的精准度与编码效率。
在 Sublime Text 中自定义代码片段的触发范围，关键在于正确设置代码片段文件中的 scope（作用域）。作用域决定了该代码片段在哪些类型的文件或语法环境下可以被触发。合理配置 scope 可以让你的代码片段只在需要的地方生效，避免干扰其他语言环境。
什么是 Scope（作用域）？
Sublime Text 使用 scope 来标识当前光标所在位置的语法类型。比如，在 JavaScript 文件中，scope 可能是 source.js；在 HTML 文件中可能是 text.html.basic。代码片段通过匹配这些 scope 来决定是否显示在自动补全列表中。
你可以在 Sublime 中通过快捷键 Ctrl+Alt+P（Windows/Linux）或 Cmd+Alt+P（Mac）查看当前光标位置的完整 scope 信息。
如何为代码片段设置作用域
编辑你的 .sublime-snippet 文件时，在 <scope> 标签内填写对应的语法 scope 即可限制其触发范围。
示例：创建一个仅在 JavaScript 文件中生效的 log 模板：
<?xml version="1.0" encoding="UTF-8"?><snippet>
<content><![CDATA[console.log($1);]]></content>
<tabTrigger>log</tabTrigger>
<scope>source.js</scope>
<description>Log to console</description>
</snippet>
这样，只有当编辑器识别为 JavaScript 语法时，输入 log + Tab 才会触发该片段。
使用 @ainative/react-sdk 为 React 应用添加 AI 聊天和积分。适用于 (1) 安装 @ainative/react-sdk，(2) 使用 useChat hook 实现聊天完成。
常见语言的 Scope 示例
- JavaScript: source.js
- HTML: text.html.basic
- CSS: source.css
- Python: source.python
- PHP: source.php
- Vue 单文件组件: text.html.vue
- JSX/React: source.js.jsx
如果你希望代码片段在多个语言中生效，可以用 meta 或更宽泛的父级 scope，例如：
<scope>source</scope> —— 匹配所有 source 开头的语言（不推荐太宽泛）或者使用逗号分隔多个 scope（注意：Sublime 不直接支持逗号分隔，需使用更高级的 context 控制，一般建议为不同语言创建独立片段）。
提高精准度：结合语法包确认 Scope
不同语法高亮包可能定义不同的 scope。例如 Vue 文件可能由 Vue Syntax Highlight 或 Vetur 提供支持，其内部 scope 可能略有差异。
建议做法：
- 打开目标类型文件（如 .vue、.jsx）
- 按下 Ctrl+Alt+P 查看实际 scope
- 将查到的 scope 填入 snippet 的 <scope> 字段
例如你在 Vue 文件中看到 scope 是 text.html.vue，那就把代码片段的 scope 设为这个值即可。
基本上就这些。正确设置 scope 能让自定义代码片段更智能、更专注，提升编码效率又避免误触。记得保存后重启 Sublime 或重新加载语法包使更改生效。
