1. 项目概述为什么双Z轴校准是3D打印质量提升的关键一步如果你玩3D打印机有一段时间了特别是用过一些DIY套件或者自己升级过机器大概率会遇到一个让人头疼的问题打印出来的模型第一层靠近左边和靠近右边的厚度总是不一样或者打印大尺寸平面时一边刮喷嘴另一边又粘不牢。这背后十有八九是你的双Z轴电机没有“对齐”。今天要聊的就是如何利用Klipper固件强大的校准功能彻底解决双Z轴不等高这个顽疾。这不仅仅是调平床那么简单而是让打印机的两个Z轴运动机构真正实现同步和等高是保证打印件尺寸精度、底面平整度和长期打印稳定性的基石。对于使用CoreXY、i3结构甚至一些龙门架Gantry结构的打印机来说双Z轴设计越来越普遍它提升了Z轴的刚性和负载能力但同时也引入了新的校准维度。传统的“手动拧螺丝”或者依赖限位开关的粗略对齐方式在追求高精度的今天已经不够看了。Klipper固件提供的Z_TILT_ADJUST和SCREWS_TILT_CALCULATE等功能结合探针可以实现自动化的、数据驱动的精确校准。这个过程我们称之为“双Z等高校准”。接下来我会结合自己给多台机器做校准的实际经验从原理到实操再到避坑指南带你完整走一遍。2. 核心原理双Z轴不同步的根源与Klipper的解决思路2.1 双Z轴系统的误差来源要解决问题先得明白问题从哪来。双Z轴电机理论上应该同步旋转带动两根丝杠或皮带同步升降。但在现实中以下几个因素几乎必然导致它们不同步机械装配误差这是最主要的来源。两个电机安装座的高度有细微差异两根丝杠的垂直度不完全一致或者连接电机与丝杠的联轴器存在微小偏心都会在组装阶段就埋下不等高的种子。电气驱动微差异即使使用同一个驱动芯片如常见的TMC2209控制两个电机驱动器的细分微步电流、散热导致的性能漂移也会有极其微小的差别。长时间运行后这种差异可能累积成可观的步数误差。负载分布不均打印头、挤出机、线材的重量并非绝对均匀地分布在X轴横梁上。如果重心稍微偏向一侧在Z轴升降启动和停止的瞬间两侧受到的阻力矩不同也可能导致短暂的失步。回差Backlash不一致两根丝杠的螺母磨损程度或预紧力不同会导致它们的反向间隙有差异。当Z轴改变运动方向时这种差异就会体现为两侧的高度差。这些误差累积起来会导致打印机的X轴横梁或整个龙门架相对于打印平台不是水平的而是倾斜的。这种倾斜用普通的自动床面网格补偿Bed Mesh是无法完全修正的因为网格补偿只修正了床面本身的起伏但无法修正喷头运动平面与床面之间的夹角。结果就是即便床面网格调得再平喷头在左端和右端距离床面的实际高度仍然不同。2.2 Klipper的校准哲学测量与补偿Klipper固件的设计哲学非常清晰承认机械误差的客观存在然后通过高精度的测量和智能的软件补偿来消除其影响。对于双Z不等高问题Klipper主要提供了两种相辅相成的工具Z_TILT_ADJUST这是核心的自动校准功能。它需要一个探针如BLTouch、电感式或电容式传感器。工作原理是探针会在预先设定的两个或更多点通常对应两个Z轴丝杠的位置进行探测测量出这些点的高度差。Klipper根据这个高度差计算出需要分别给两个Z电机补偿多少步进脉冲才能让X轴横梁变得水平。它补偿的是电机步数而不是机械结构本身。校准后Klipper会在每次打印开始前如果G-code中调用了自动执行这个补偿确保本次打印的起点是水平的。SCREWS_TILT_CALCULATE这是一个辅助的、指导性的工具。同样需要探针。它会探测床面四个螺丝角或三个的位置然后告诉你每个调节螺丝需要拧动多少圈、朝哪个方向拧才能让床面与当前可能已经倾斜的X轴横梁平行。这个功能的目的是在机械层面进行粗调为Z_TILT_ADJUST创造一个更好的初始条件或者在不具备双独立Z电机驱动的打印机上使用。我们的目标是首先利用SCREWS_TILT_CALCULATE把床面调得与当前X轴大致平行然后通过Z_TILT_ADJUST让X轴自身变水平。两者结合才能得到真正平行的喷头运动平面和打印平面。注意Z_TILT_ADJUST功能要求你的两个Z电机必须由两个独立的步进电机驱动器控制通常是主板上的两个Z接口或通过扩展板实现。如果两个Z电机是并联在同一驱动器上的那么软件无法对它们进行独立控制这个功能就无法使用。这种情况下你只能依赖SCREWS_TILT_CALCULATE进行机械调平并确保机械装配尽可能精确。3. 校准前的准备工作硬件检查与固件配置3.1 机械与电气检查清单在开始软件校准之前必须确保机械和电气基础是牢固的否则校准结果会不稳定甚至损坏机器。框架稳固性用力摇晃打印机框架检查是否有明显的松动或晃动。特别是龙门架结构的机器确保所有V轮与型材接触紧密偏心螺母调整适当既不能太松有晃动也不能太紧阻力过大。Z轴运动顺畅手动旋转Z轴电机轴最好断电操作感受两根丝杠的阻力是否均匀、平滑。确保丝杠清洁、润滑适当使用专用的润滑脂如锂基脂或PTFE脂。电机安装与联轴器检查两个Z电机是否安装牢固联轴器是否紧固并且是柔性联轴器可以补偿少量不同轴度。刚性联轴器对安装精度要求极高更容易出现问题。探针精度验证这是所有测量的基础。重复触发你的探针例如BLTouch10次记录下探针报告的Z高度。其标准差应该非常小例如小于0.01mm。如果波动大需要检查探针安装是否牢固探针针杆是否弯曲或者清理探针的感应区域。热床预热在进行任何与高度相关的校准前必须将热床加热到你的常用打印温度例如60°C并等待至少5-10分钟让整个床面热膨胀达到稳定状态。冷床和热床的高度差可能高达0.1-0.2mm。3.2 Klipper配置文件关键参数详解接下来我们需要在Klipper的printer.cfg配置文件中添加或修改相关模块。以下是核心配置段落[stepper_z] step_pin: ... # 你的Z电机步进引脚 dir_pin: ... enable_pin: ... rotation_distance: 8 # 以常见的T8丝杠为例导程8mm microsteps: 16 endstop_pin: probe:z_virtual_endstop # 使用探针作为Z限位 position_min: -5 # 允许向下移动一点用于探测 position_max: 250 # 你的Z轴最大高度 [stepper_z1] step_pin: ... # 第二个Z电机的步进引脚必须独立 dir_pin: ... enable_pin: ... rotation_distance: 8 # 必须与stepper_z严格一致 microsteps: 16 [tmc2209 stepper_z] # 驱动配置以TMC2209为例 uart_pin: ... run_current: 0.8 stealthchop_threshold: 999999 # 建议在校准和打印时禁用StealthChop以获得更一致的动力 [tmc2209 stepper_z1] uart_pin: ... run_current: 0.8 stealthchop_threshold: 999999 [probe] # 探针配置以BLTouch为例 pin: ^PA4 # 控制信号引脚 x_offset: -25.0 # 探针相对于喷嘴的X偏移 y_offset: -5.0 # 探针相对于喷嘴的Y偏移 z_offset: 0 # 这个值需要通过PROBE_CALIBRATE命令校准先设为0 speed: 5.0 # 探测速度建议从较慢开始 samples: 3 # 每次探测采样次数 sample_retract_dist: 2.0 samples_result: median # 取中位数抗干扰更好 samples_tolerance: 0.01 # 多次采样允许的误差范围 samples_tolerance_retries: 5 # 超限重试次数 [bed_mesh] # 床面网格补偿建议先配置但双Z校准优先级更高 speed: 100 horizontal_move_z: 5 mesh_min: 10, 10 mesh_max: 190, 190 probe_count: 5,5 fade_start: 1.0 fade_end: 10.0 [z_tilt] # 这是双Z等高校准的核心模块 z_positions: # 定义两个探测点的坐标应尽可能靠近Z轴丝杠中心 -50, 25 # 第一个点对应左边丝杠大致位置 250, 25 # 第二个点对应右边丝杠大致位置 points: # 实际探测点的坐标可以比z_positions更靠内一点以避免撞到限位 -40, 25 240, 25 speed: 50.0 horizontal_move_z: 5 retries: 5 retry_tolerance: 0.01配置要点解析stepper_z1的rotation_distance必须与stepper_z完全一致这是计算补偿步数的基础。z_tilt模块中的z_positions是理论上的“支点”位置用于计算倾斜角度。points是实际探测位置。为了让计算更准确探测点应尽量靠近丝杠中心但也要考虑机器行程限制避免撞边。retry_tolerance很重要它设定了重复探测一致性的阈值。如果两次探测结果差异超过这个值会触发重试。设置得太松如0.1mm可能掩盖问题太紧如0.002mm可能导致频繁重试失败。0.01mm是一个比较合理的起点。4. 分步实操从螺丝粗调到软件精校4.1 第一步手动粗调与探针Z偏移校准在运行任何自动校准前我们需要一个尽可能好的起点。手动粗略调平使用一张A4纸手动将喷嘴移动到床的四个角附近通过调整床脚螺丝让喷嘴与床面的距离大致相同纸张有轻微阻力。这个过程很传统目的是避免床面倾斜过于严重导致后续探测时喷嘴或探针撞到床。校准探针Z偏移这是最关键的一步所有后续测量的准确性都基于此。将喷嘴和热床加热到工作温度。在Klipper网页界面如Mainsail/Fluidd或通过控制台输入命令PROBE_CALIBRATE。打印机会自动进行一系列操作移动到中心、探测、将喷嘴下降到探测点。此时你使用一张纸片或感觉器手动测试喷嘴与床面的间隙。通过控制台的TESTZ Z-0.1向下或TESTZ Z0.1向上命令来微调喷嘴高度直到纸张有轻微的摩擦感。调整到位后输入ACCEPT然后输入SAVE_CONFIG保存。这个z_offset值会自动更新到你的[probe]配置中。务必确保这个值准确无误。4.2 第二步使用SCREWS_TILT_CALCULATE进行床面平行度粗调现在我们让床面与当前可能倾斜的X轴横梁平行。在配置文件中添加或启用screws_tilt_adjust功能如果你的Klipper版本支持。你需要精确测量床面调节螺丝的位置坐标。[screws_tilt_adjust] screw1: 30, 30 # 螺丝1的XY坐标通常是前左 screw1_name: front left screw screw2: 30, 190 # 螺丝2的坐标前右 screw2_name: front right screw screw3: 190, 190 # 螺丝3的坐标后右 screw3_name: rear right screw screw4: 190, 30 # 螺丝4的坐标后左 screw4_name: rear left screw horizontal_move_z: 5 speed: 100 screw_thread: CW-M3 # 螺丝螺纹方向和规格CW-M3表示顺时针拧紧的M3螺丝保存配置并重启Klipper。输入命令SCREWS_TILT_CALCULATE。打印机将依次探测每个螺丝附近的位置然后输出类似下面的结果// 探测结果 // front left screw: 太紧 0.100 圈 或 太松 0.100 圈 // front right screw: 太紧 0.050 圈 或 太松 0.050 圈 // rear right screw: 基准 // rear left screw: 太松 0.075 圈 或 太紧 0.075 圈按照提示逐个调整床脚螺丝。记住方向“太紧”意味着你需要拧松该螺丝“太松”意味着你需要拧紧。建议使用带刻度的旋钮或记录扳手转动的角度进行微调。调整一轮后再次运行SCREWS_TILT_CALCULATE。重复这个过程直到所有螺丝的调整量都小于0.02圈即大约“钟表盘”上7分钟的角度。此时床面与当前X轴横梁已经非常平行了。4.3 第三步执行Z_TILT_ADJUST实现双Z轴等高床面平行度调好后现在我们来解决X轴横梁自身的倾斜问题。确保[z_tilt]模块已正确配置并启用。输入命令Z_TILT_ADJUST。打印机会依次移动到你在points中定义的两个点进行探测。这个过程可能会重复几次retries直到连续两次探测的倾斜计算结果差异小于retry_tolerance。校准完成后Klipper会输出类似信息// z_tilt: 已调整 (x diff0.123, y diff0.000, 调整了 stepper_z12.3, stepper_z1-7.8)。这表示它计算出了倾斜度并对两个Z电机应用了步数偏移补偿。必须输入SAVE_CONFIG命令。这个操作会将计算出的补偿值position_endstop的调整量永久保存到每个stepper_z和stepper_z1的配置中。重启后依然有效。实操心得第一次运行Z_TILT_ADJUST时补偿值可能会比较大几十个微步。这是正常的说明你之前的机械倾斜确实严重。保存配置后强烈建议你再次运行一次SCREWS_TILT_CALCULATE。因为X轴被调平后床面相对于这个新的水平X轴又可能不平行了。重复步骤4.2和4.3一到两次进行“迭代校准”直到Z_TILT_ADJUST的补偿值变化很小且SCREWS_TILT_CALCULATE显示所有螺丝基本无需调整。这时你的打印机才达到了真正的机械与软件联合校准的最佳状态。5. 集成到打印流程与高级技巧5.1 在切片软件中自动化校准流程校准不是一劳永逸的但我们可以让它变得无感。最好的方法是在每份打印G-code的开始部分START_PRINT宏中加入校准命令。在你的Klipper宏配置中可以这样定义[gcode_macro START_PRINT] gcode: {% set BED_TEMP params.BED_TEMP|default(60)|int %} {% set EXTRUDER_TEMP params.EXTRUDER_TEMP|default(200)|int %} # 加热热床 M140 S{BED_TEMP} # 等待热床达到目标温度 M190 S{BED_TEMP} # 加热挤出机 M104 S{EXTRUDER_TEMP} # 执行双Z轴等高校准在热态下进行 Z_TILT_ADJUST # 执行床面网格补偿可选但推荐 BED_MESH_CALIBRATE # 等待挤出机达到目标温度 M109 S{EXTRUDER_TEMP} # 进行回抽、清理喷嘴等后续操作 G28 ; 回原点注意Z_TILT_ADJUST后可能需要重新G28 Z轴但Klipper通常会自动处理 ...然后在你的切片软件如PrusaSlicer、Cura的打印机设置中将开始G-code修改为调用这个宏并传递温度参数START_PRINT BED_TEMP[first_layer_bed_temperature] EXTRUDER_TEMP[first_layer_temperature]。这样每次打印前打印机都会自动进行双Z校准和床面网格校准确保每次打印都从一个完美的水平起点开始。5.2 应对特殊结构与疑难杂症三Z轴或更多Z轴Klipper同样支持。在[z_tilt]模块中你需要定义对应数量的z_positions和points。原理相同计算会更复杂一些但Klipper能处理。使用皮带传动的Z轴如Voron Trident校准流程完全一致。需要注意的是皮带传动的回差和拉伸可能比丝杠更明显确保皮带张力适中且两侧一致至关重要。校准后应检查皮带是否有跳齿风险。校准后第一层仍然不均匀检查探针Z偏移的重复性重新运行几次PROBE_CALIBRATE的TESTZ步骤确认偏移值稳定。检查床面网格的有效性在运行Z_TILT_ADJUST后再运行BED_MESH_CALIBRATE并观察生成的网格曲面是否平滑。如果网格起伏依然很大可能是床面本身形变严重超出了软件补偿的能力范围需要考虑更换或加固热床。检查X轴本身的直线度如果X轴导轨或型材弯曲那么无论Z轴如何校准喷头运动轨迹也不是直的。这需要机械修复。电机丢步或异响如果Z_TILT_ADJUST给出的补偿值非常大例如超过1mm的等效步数可能会导致某个电机长期处于非零点的偏移位置运行增加丢步风险。如果出现这种情况应该先进行机械调整松开机架重新对齐电机和丝杠减小初始倾斜然后再进行软件校准。6. 校准效果验证与长期维护6.1 如何验证校准成功最直观的验证就是打印一个单层测试模型。推荐打印一个覆盖大部分打印面积的、单层的正方形或圆形厚度设置为你的层高如0.2mm。目视观察打印完成后观察整个第一层。理想的状况是所有区域的线条都均匀、连续、紧密贴合没有局部透光喷嘴过高或被刮起毛边喷嘴过低。手感触摸用手指轻轻抚摸打印表面。应该感觉整体平整光滑没有明显的“台阶感”或一边厚一边薄的感觉。千分尺测量如果你有数显千分尺可以在打印件的不同位置左前、右前、左后、右后测量其厚度。厚度差异应控制在±0.02mm以内这已经是非常优秀的表现了。专用测试模型可以下载一些“第一层测试”模型它们通常包含多个小方块或同心圆能更细致地反映床面不同区域的高度一致性。6.2 长期稳定性与复查周期双Z等高校准不是永久性的。以下情况可能需要重新校准机械变动后任何对打印机框架、Z轴组件、电机、探针的拆卸、重装或调整之后。搬运打印机后即使轻微移动也可能改变机架的应力分布。周期性维护建议每打印50-100小时或至少每个月运行一次Z_TILT_ADJUST和SCREWS_TILT_CALCULATE进行检查。如果补偿值相比上次保存的变化很小比如小于0.02mm可以忽略如果变化较大则保存新的配置。出现打印质量问题如果突然发现第一层问题重现应将其作为首要排查项。我的个人维护习惯我会在Klipper的宏里创建一个CHECK_LEVEL宏里面依次调用Z_TILT_ADJUST但不保存、SCREWS_TILT_CALCULATE和BED_MESH_CALIBRATE也不保存。每周或感觉不对劲时跑一次快速查看各项数据。只有确认需要更新时才手动运行保存命令。这样既能监控状态又避免了因误操作或临时波动覆盖掉好的配置。完成一套完整的双Z等高校准并集成到日常打印流程中可能是提升FDM 3D打印机打印质量最有效、性价比最高的投资之一。它解决的是系统性的几何误差让后续的挤出流量校准、压力提前等高级调校有一个坚实可靠的基础平台。花上半个小时理解和操作这个过程换来的将是无数个小时的完美第一层和令人安心的打印成功率。