handlebars插件不生效需先确认语法绑定是否正确：右键右下角“plain text”→“open all with current extension as...”→选“handlebars”；若无此选项，检查package control中是否安装并启用handlebars插件（作者daa84），未安装则重新安装并重启。
Handlebars插件不生效？先确认语法绑定是否正确
Sublime Text 默认不识别 .hbs 或 .handlebars 文件后缀，即使装了插件，打开文件时右下角仍显示“Plain Text”——这是最常见失效原因。必须手动将文件类型与 Handlebars 语法关联。
操作路径：右键编辑器右下角的 “Plain Text” → “Open all with current extension as...” → 搜索并选择 “Handlebars”。如果列表里没有 Handlebars，说明插件没装成功或未启用。
- 检查已安装插件：按
Ctrl+Shift+P输入Package Control: List Packages，确认Handlebars出现在列表中（注意大小写，不是handlebars或hbs） - 若未出现，重新安装：命令面板输入
Package Control: Install Package，搜索Handlebars，选第一个（作者是daa84，GitHub 仓库名sublime-handlebars） - 装完重启 Sublime Text，再打开一个
.hbs文件测试
为什么 Emmet 在 .hbs 文件里缩写不展开？
Emmet 默认只在 HTML、CSS 等原生支持的语法下激活。Handlebars 是模板语言，需要显式启用支持，否则 div>ul>li*3 按 Tab 后毫无反应。
解决方法是在用户设置中添加 Emmet 的语法白名单：
{
"emmet_include_languages": {
"handlebars": "html"
}
}
注意："handlebars" 必须和右下角显示的语法名称完全一致（可通过 View → Syntax → Open all with current extension as... 查看当前激活的语法 ID）；"html" 表示复用 HTML 的 Emmet 规则，支持标签缩写、属性补全等。
- 别写成
"hbs"或"Handlebars"（首字母大写），Sublime 内部识别的是小写语法 ID - 如果同时用 Svelte 或 Vue 单文件组件，可追加更多映射，如
"vue-html": "html" - 改完保存设置文件，无需重启，新打开的
.hbs文件立即生效
自动补全失效或提示错乱？检查插件冲突和作用域
Handlebars 插件本身不提供智能变量补全（比如 {{user.name}} 中的 name），它只负责高亮和基础结构识别。如果你依赖的是类似 JavaScript 变量推导的补全，那大概率是其他插件（如 SublimeCodeIntel 或 JSCompletions）在干扰。
典型现象：输入 {{ 后弹出一堆无关函数名，或者 {{#if 被自动改成 {{#if()}}。
- 临时禁用可疑插件：命令面板输入
Package Control: Disable Package，逐个关掉 JS/TS 相关补全类插件，观察 Handlebars 行为是否恢复稳定 - Handlebars 插件的补全逻辑基于文本模式匹配，不解析上下文数据结构，所以别指望它猜出你传入的对象字段
- 如需真实数据驱动补全，得配合外部工具（如 VS Code + Handlebars IntelliSense），Sublime 生态目前无成熟方案
汉化后菜单项变英文？Handlebars 插件不兼容中文界面
部分老版本 Handlebars 插件（v1.2.0 之前）读取菜单配置时硬编码了英文路径，一旦系统语言切换为中文，其自定义菜单项（如 “Insert Partial”）就消失或无法响应。
验证方式：按 Ctrl+Shift+P 输入 Handlebars，看是否有命令出现；如果没有，基本是兼容问题。
- 升级插件：确保使用最新版
Handlebars（截至 2026 年 7 月，最新为 v1.5.0，已修复多语言菜单加载逻辑） - 手动触发命令：即使菜单不可见，仍可通过命令面板执行，例如输入
Handlebars: Insert Each Block - 若坚持用旧版，可临时切回英文界面（
Help → Language → English），操作完再切回中文
