配置修改说明

本页面汇总修改 Klipper 配置时最常见的格式问题。修改配置后请保存并重启 Klipper，根据报错信息定位问题。

注意

一般配置项不可随意缩进。只有 [gcode_macro XXXX] 内 gcode: 后的 G-code 内容才需要按照宏语法进行缩进。

空格与缩进错误

错误示例：

正确示例：

仅注释 [probe] 段头是不够的。必须将该配置段内的所有参数一起注释或删除，直到下一个 [xxxx] 配置段。

下例中下一个配置段为 [homing_override]。

错误示例：

正确示例：

报错关键词	常见原因	解决方法
`Option 'xxx' is not valid`	配置参数名拼写错误	检查参数名是否与官方文档一致
`Section 'xxx' is not a valid config section`	配置段名称错误或插件缺失	检查配置段拼写、Klipper 版本和插件安装状态
`Unable to open config file`	include 引用的文件不存在	检查文件路径是否正确
`Unable to parse option`	参数格式不符合要求	检查数字、坐标、逗号和中文标点
`Pin 'xxx' is not a valid pin`	引脚名格式错误	按主板文档确认正确的引脚名
`pin xxx used multiple times`	同一引脚被多个功能重复占用	搜索所有 include 文件并删除重复占用
`Duplicate chip name`	同名配置段重复出现	删除重复的 `[xxxx]` 配置段
`Unknown temperature sensor`	温度传感器类型拼写错误	确认 `sensor_type` 名称正确

更多配置启动类报错请参考：配置类报错。