Sublime Text 是编辑 Home Assistant YAML 配置的轻量高效工具,需安装 YAML、Pretty YAML 插件实现语法高亮与格式化,并搭配 SublimeLinter + yamllint 实时校验;须手动验证配置并重启生效。

Sublime Text 是编写 Home Assistant YAML 配置文件的轻量高效选择,尤其适合熟悉快捷键、追求响应速度和自定义体验的用户。它不自带 YAML 校验或 Home Assistant 专属支持,但通过简单配置就能获得语法高亮、自动缩进、错误提示等实用功能。
安装必要插件:YAML 和 Pretty YAML
Sublime 默认不识别 YAML 语法。需通过 Package Control 安装两个核心插件:
- YAML:提供基础语法高亮、括号匹配、折叠支持;
- Pretty YAML:一键格式化(Ctrl+Alt+Shift+P 或 Cmd+Alt+Shift+P),自动修正缩进、排序键名、补全引号,避免因空格或换行导致的解析失败。
安装后,将 .yaml 或 .yml 文件关联为 YAML 语法(右下角点击语言名 → “Open all with current extension as…” → YAML)。
启用实时校验:用 SublimeLinter + SublimeLinter-contrib-yamllint
仅靠格式化不能发现逻辑错误(如无效服务名、拼错的设备 ID)。推荐搭配:
- 先装 SublimeLinter(主框架);
- 再装 SublimeLinter-contrib-yamllint(YAML 专用检查器);
- 确保系统已安装
yamllint(终端运行pip install yamllint)。
配置好后,保存文件时会标出缩进错误、重复键、多余空格等,并在状态栏显示警告/错误总数。
提升效率的小技巧
Home Assistant 的 YAML 嵌套深、重复多,这些习惯能省时间:
- 用 Ctrl+Shift+P(Cmd+Shift+P)调出命令面板,快速切换语法、运行 Pretty YAML、跳转到定义;
- 对常用结构(如
automation模板、input_boolean块)保存为 Snippets,输入缩写后 Tab 展开; - 开启 “Detect Indentation”(设置 → Settings → “detect_indentation”: true),让 Sublime 自动适配 .yaml 文件常用空格数(通常为 2);
- 把
configuration.yaml和automations.yaml等放入同一项目文件夹,用 Project → Save Project As… 保存工作区,方便多文件协同编辑。
调试前必做:验证与重启
Sublime 再顺手也只是编辑器——写完必须验证才能生效:
- 在 Home Assistant 前端进入 设置 → 系统 → 日志 → 最新日志,点“检查配置”;
- 若报错,复制错误位置(如
automations.yaml:42),回到 Sublime 跳转到对应行(Ctrl+G 输入 42); - 确认无误后,再执行“重启”;切勿跳过检查直接重启,否则可能启动失败卡在维护模式。
基本上就这些。不复杂但容易忽略的是:YAML 对空格敏感,而 Sublime 不会替你“猜意图”,保持缩进统一、善用格式化和校验,就能稳稳写好自动化配置。










