如何写好 Home Assistant YAML 配置3 条规则、1 张决策表和一套排错路径【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io刚把 Home Assistant 跑起来打开 configuration.yaml满屏的冒号和缩进不知道从哪下手也不敢乱存。其实写 YAML 配置的核心知识没那么多3 条规则能避开九成报错再分清什么时候该切到 UI 界面。下面四部分一个下午能看完。你真正需要知道的 YAML 规则忘掉完整的 YAML 语法教程吧。写 Home Assistant 配置时你真正会踩的就三个坑。记住这 3 条就不会报错1. 缩进必须 2 个空格严禁 Tab每一层缩进固定 2 个空格用 Tab 必炸sensor: - platform: mqtt # 每层缩进 2 个空格 name: Temperature2. 冒号后面必须留空格key: value这个格式里冒号和值之间空格不能省name: 客厅灯 # ✅ 冒号后有空格 # name:客厅灯 # ❌ 少个空格直接解析失败3. on / off 要加引号YAML 会把没加引号的on、ON、off当成布尔值 true/false想把状态写成字符串时state: on # 必须加引号否则被解析成 true完整的 Home Assistant YAML 语法细节可以翻 YAML 语法文档但日常够用的就上面这几条。跟着敲一遍从零配置你的第一个设备以 MQTT 温度传感器为例整套 configuration.yaml 写法流程就四步复制 → 粘贴 → 检查 → 重启。第一步打开 configuration.yaml。Core 安装可以直接在 设置 文件编辑器 里改更推荐用带 YAML 高亮的代码编辑器缩进问题一眼就能看出来第二步把这段配置追加到文件末尾。每行都写了注释边看边改# 追加到 configuration.yaml 末尾 sensor: # 顶层键对应所有传感器 - platform: mqtt # 数据源MQTT broker name: 客厅温度 state_topic: sensor/living/temp # 订阅的主题 unit_of_measurement: °C第三步先别急着重启。去 设置 工具 YAML 页点检查配置语法问题会直接列出来比翻日志快得多第四步检查通过就点 Restart。起来之后在实体列表里看到客厅温度并且数值在刷新你的第一个 YAML 设备就活了 ✅UI 还是 YAML一张决策表讲清楚新手最常问界面都能做的事为什么还要学 YAML答案是看场景你要做的事用哪个开关灯、改名、写一条 Home Assistant 自动化配置UI30 秒搞定批量改十几条自动化、重构配置结构YAML好整体比对也好备份涉及密码、API 密钥secrets.yaml YAML敏感值别留在主文件里加一个没有界面的硬件集成YAML没得选Home Assistant UI 设置只需要记住三条路径设置 设备与服务所有集成的入口点右下角添加集成跟着向导走设置 自动化与场景创建和管理自动化编辑器里可以切到编辑 YAML模式仪表盘右上角 编辑仪表盘拖卡片改布局⚠️ 注意一点在 configuration.yaml 里定义过的项UI 里会带 (YAML) 标识且不让改。动手编辑前先确认这项归谁管两边同时改必出冲突。配置报错90% 是这几个原因遇到 Home Assistant 配置报错别慌着重启九成是下面这四个1. Tab 缩进报错报错found character \t that cannot start any token根因某行缩进用了 Tab 而不是空格修复编辑器里开启显示空白字符找到 Tab 换成 2 个空格保存后重新检查2. 布尔值没加引号报错not a valid value for dictionary value data根因on/off被解析成布尔值但那个位置要的是字符串修复加单引号state: on这类报错一次修复终身免疫3. UI 与 YAML 冲突现象UI 里想改的设置是灰的或实体名后挂着 (YAML)根因该项在 configuration.yaml 里已有定义YAML 优先修复选一个地方管。想让 UI 接管就把 YAML 里对应条目删掉再重启4. secrets 不生效现象写了!secret集成拿不到密码日志里报凭据缺失根因名字和 secrets.yaml 里的键对不上或文件放错了目录修复在 secrets.yaml 里加一行logger: debug日志会打印 secret 到底从哪个文件加载的收尾上手之后值得深入的两件事用!include把配置按领域拆成多个文件用!env_var把密码挪进环境变量。这两招会让你的 configuration.yaml 保持整洁很多年进阶可以看 拆分配置文档。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何写好 Home Assistant YAML 配置：3 条规则、1 张决策表和一套排错路径
如何写好 Home Assistant YAML 配置3 条规则、1 张决策表和一套排错路径【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io刚把 Home Assistant 跑起来打开 configuration.yaml满屏的冒号和缩进不知道从哪下手也不敢乱存。其实写 YAML 配置的核心知识没那么多3 条规则能避开九成报错再分清什么时候该切到 UI 界面。下面四部分一个下午能看完。你真正需要知道的 YAML 规则忘掉完整的 YAML 语法教程吧。写 Home Assistant 配置时你真正会踩的就三个坑。记住这 3 条就不会报错1. 缩进必须 2 个空格严禁 Tab每一层缩进固定 2 个空格用 Tab 必炸sensor: - platform: mqtt # 每层缩进 2 个空格 name: Temperature2. 冒号后面必须留空格key: value这个格式里冒号和值之间空格不能省name: 客厅灯 # ✅ 冒号后有空格 # name:客厅灯 # ❌ 少个空格直接解析失败3. on / off 要加引号YAML 会把没加引号的on、ON、off当成布尔值 true/false想把状态写成字符串时state: on # 必须加引号否则被解析成 true完整的 Home Assistant YAML 语法细节可以翻 YAML 语法文档但日常够用的就上面这几条。跟着敲一遍从零配置你的第一个设备以 MQTT 温度传感器为例整套 configuration.yaml 写法流程就四步复制 → 粘贴 → 检查 → 重启。第一步打开 configuration.yaml。Core 安装可以直接在 设置 文件编辑器 里改更推荐用带 YAML 高亮的代码编辑器缩进问题一眼就能看出来第二步把这段配置追加到文件末尾。每行都写了注释边看边改# 追加到 configuration.yaml 末尾 sensor: # 顶层键对应所有传感器 - platform: mqtt # 数据源MQTT broker name: 客厅温度 state_topic: sensor/living/temp # 订阅的主题 unit_of_measurement: °C第三步先别急着重启。去 设置 工具 YAML 页点检查配置语法问题会直接列出来比翻日志快得多第四步检查通过就点 Restart。起来之后在实体列表里看到客厅温度并且数值在刷新你的第一个 YAML 设备就活了 ✅UI 还是 YAML一张决策表讲清楚新手最常问界面都能做的事为什么还要学 YAML答案是看场景你要做的事用哪个开关灯、改名、写一条 Home Assistant 自动化配置UI30 秒搞定批量改十几条自动化、重构配置结构YAML好整体比对也好备份涉及密码、API 密钥secrets.yaml YAML敏感值别留在主文件里加一个没有界面的硬件集成YAML没得选Home Assistant UI 设置只需要记住三条路径设置 设备与服务所有集成的入口点右下角添加集成跟着向导走设置 自动化与场景创建和管理自动化编辑器里可以切到编辑 YAML模式仪表盘右上角 编辑仪表盘拖卡片改布局⚠️ 注意一点在 configuration.yaml 里定义过的项UI 里会带 (YAML) 标识且不让改。动手编辑前先确认这项归谁管两边同时改必出冲突。配置报错90% 是这几个原因遇到 Home Assistant 配置报错别慌着重启九成是下面这四个1. Tab 缩进报错报错found character \t that cannot start any token根因某行缩进用了 Tab 而不是空格修复编辑器里开启显示空白字符找到 Tab 换成 2 个空格保存后重新检查2. 布尔值没加引号报错not a valid value for dictionary value data根因on/off被解析成布尔值但那个位置要的是字符串修复加单引号state: on这类报错一次修复终身免疫3. UI 与 YAML 冲突现象UI 里想改的设置是灰的或实体名后挂着 (YAML)根因该项在 configuration.yaml 里已有定义YAML 优先修复选一个地方管。想让 UI 接管就把 YAML 里对应条目删掉再重启4. secrets 不生效现象写了!secret集成拿不到密码日志里报凭据缺失根因名字和 secrets.yaml 里的键对不上或文件放错了目录修复在 secrets.yaml 里加一行logger: debug日志会打印 secret 到底从哪个文件加载的收尾上手之后值得深入的两件事用!include把配置按领域拆成多个文件用!env_var把密码挪进环境变量。这两招会让你的 configuration.yaml 保持整洁很多年进阶可以看 拆分配置文档。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考