Klipper宏命令的价值
Klipper固件之所以在3D打印爱好者中备受推崇，除了出色的运动控制精度和输入整形功能外，其强大的宏命令系统也是核心原因之一。通过编写自定义宏，你可以将多个重复性操作合并为一个命令，实现打印过程中的自动化控制，甚至搭建复杂的条件触发逻辑。
Klipper的宏命令系统基于Jinja2模板引擎，支持变量、条件判断、循环和函数调用。这意味着你可以像编写程序一样编写 3D打印机 的控制逻辑——在打印开始前自动执行热床调平，在打印过程中动态调整风扇转速，在打印完成后自动执行关机动作。
本文将从宏命令的基础语法开始，逐步深入到高级实战案例，帮助Klipper用户充分挖掘固件的自动化潜力。
宏命令基础：G-Code宏的编写方法
Klipper宏命令以「gcode_macro」配置段的形式定义在printer.cfg文件中。最基本的格式如下：在每个宏定义中，gcode字段内的内容可以是标准的G-Code命令，也可以是Klipper专用的G-Code别名命令。
[gcode_macro MY_MACRO]
gcode:
G28 ; 回零
G1 Z10 F300 ; 抬升Z轴
M117 自定义宏执行完成宏命令支持参数传递。在调用宏时附加的参数可以通过「params」字典读取。例如定义一个设置热床温度到指定值的宏：调用「SET_BED 60」时，params.TEMP的值就是60。参数支持整数、浮点数和布尔值类型，Klipper会自动进行类型转换。
变量作用域是宏命令中容易搞混的概念。宏内部的变量默认只在当前宏中有效，但你可以使用「variable_xxx」语法定义全局变量，在所有宏中共享。这对于需要跨宏持久化状态的场景（如记录累计打印时长、统计挤出量等）非常有用。
条件判断与循环控制逻辑
Jinja2模板引擎为Klipper宏命令带来了完整的逻辑控制能力。条件判断使用「{% if %}」语句，可以比较数值、字符串和布尔值。典型应用是检查喷嘴温度是否达到设定值后再开始打印，避免冷挤出损坏热端。
循环控制使用「{% for %}」语句，适合需要重复执行同类型操作的场景。例如批量归位多个轴、逐个加热多挤出机系统的各个喷嘴等。循环可以嵌套使用，但要注意性能——过多的嵌套循环会导致主控板处理延迟，影响打印过程中的实时响应。
Klipper还提供了丰富的状态查询函数，可以在宏中实时读取打印机的运行状态。常用的有「printer.toolhead.position」读取当前坐标、「printer.heater_bed.temperature」读取热床温度、「printer.extruder.temperature」读取喷嘴温度等。这些函数返回值可以直接参与条件判断和计算。
需要注意的是，宏命令的每次执行都会占用主控板的一个处理周期。如果宏中包含大量计算（如数学运算、字符串拼接等），建议尽量简化逻辑或者将计算分散到多个宏中，避免在打印过程中因宏执行过长导致步进电机脉冲丢失。
打印过程动态控制实战
打印过程中的动态控制是宏命令最实用的场景之一。例如在每次层高变化时自动调整风扇转速：对于前10层使用低速风扇（30%）以增强层间附着力，10层以后切换到常规速度（60%），悬垂面较多的区域则提高到100%。
实现这一功能的思路是在切片软件中的「层变化G-Code」中插入宏调用。在OrcaSlicer的「After layer change G-code」字段中添加宏命令「CHECK_LAYER_FAN」，然后在printer.cfg中定义这个宏：根据当前层号判断层高区间，输出对应的M106风扇转速指令。
更高级的应用是温度自适应控制。当打印速度超过设定阈值时（如高速填充阶段），自动降低打印温度5-10度以防止过度挤出；当打印速度降低到慢速区（如精细外壁），自动回升温度保证层间融合质量。通过读取「printer.toolhead.velocity」的实时值，宏可以动态调整热端温度设定。
另一个实用场景是耗材耗尽自动处理。很多Klipper配置中安装了断料检测传感器，当传感器触发时，宏可以自动执行「暂停打印→抬升Z轴→回退耗材→记录暂停位置」的一整套动作，等待用户换料后自动恢复打印，全程无需人工干预。
配套传感器与自动化闭环
要充分发挥Klipper宏命令的自动化能力，还需要配合多种传感器实现闭环控制。常用的传感器包括热床调平传感器（如BL-Touch、Klicky Probe）、腔体温度传感器、耗材检测传感器和振动传感器。
热床调平后可以自动将补偿数据写入「BED_MESH_CALIBRATE」的结果中，并在每次打印前自动加载。通过结合「SAVE_CONFIG」命令，调平数据可以持久化保存，下次开机无需重新调平。对于打印农场中管理多台机器来说，这种自动化调平机制可以节省大量人工维护时间。
腔体温度传感器配合宏命令可以实现主动式腔体加热控制。对于 ABS 打印，保持腔体温度在55-65度是防止翘曲的关键。宏可以设定腔体温控逻辑：当腔体温度低于目标值时，开启加热元件或调节排风扇；高于目标值时，自动关闭并保持循环风。
振动传感器可以用于「智能共振补偿」功能。Klipper的Input Shaper需要测量打印机的共振频率，传统方法需要手动执行「MEASURE_RESONANCES」命令并分析图谱。通过接入加速度计传感器并编写自动测量宏，可以在每次开机时自动测量共振频率并应用最佳滤波配置，不用任何手动操作即可获得最优打印质量。
来源：Klipper官方配置参考文档、Klipper社区宏命令库整理。