YAML配置中行首句点（.）的作用？ESPHome锚点场景答疑

核心本质 #

你配置里的.number是自定义的锚点载体节点，和ESPHome的number组件没有直接关联，只是一个用来存放重复配置片段的容器：

• 行首的句点是YAML允许的合法键名前缀，作用是和实际的ESPHome组件配置节点（比如真正的number:块）做区分，避免被ESPHome的解析器当成一个实际的设备组件来处理。
• 这个节点唯一的作用就是把通用的配置参数打包成锚点（&AnchorDelay），方便后续在真正的组件配置里用<<: *AnchorDelay语法合并复用，减少重复代码。

结合你的示例解析 #

1. 定义锚点载体

.number: &AnchorDelay
optimistic: true
min_value: 0
max_value: 600
step: 1
initial_value: 0

这里的.number节点不会被ESPHome识别为一个number组件，它只是一个存放通用配置的“临时容器”，同时给这个容器绑定了AnchorDelay锚点。

2. 复用锚点配置
   在真正的number:组件列表里，每个条目通过<<: *AnchorDelay把.number里的通用参数合并进来，再补充各自独有的id、name等参数：

number:
  - platform: template
    <<: *AnchorDelay
    id: "SwitchMainDelay"
    name: "Main Switch Delay"

这样就不用每个number组件都重复写optimistic、min_value这些相同配置了。

3. 嵌套锚点的覆盖逻辑
   你示例里的web_server锚点复用后覆盖sorting_group_id，也是YAML的标准合并规则：当合并锚点后再写相同键名，会用新值覆盖锚点里的旧值，这和句点前缀的节点无关，是YAML锚点的基础特性。

关键注意点 #

• 这种句点前缀的命名是ESPHome社区的约定俗成写法，不是YAML的语法强制要求，目的就是直白地告诉读者“这是个仅用于复用的配置片段，不是实际设备”。
• ESPHome的配置解析器会自动忽略所有顶级节点中键名以句点开头的内容，所以这类节点只会作为锚点载体存在，不会对设备功能产生任何直接影响。

内容的提问来源于stack exchange，提问作者Tango