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轴电机理论上应该同步旋转，带动两根丝杠或皮带同步升降。但在现实中，以下几个因素几乎必然导致它们不同步：

1. 机械装配误差：这是最主要的来源。两个电机安装座的高度有细微差异，两根丝杠的垂直度不完全一致，或者连接电机与丝杠的联轴器存在微小偏心，都会在组装阶段就埋下不等高的种子。
2. 电气驱动微差异：即使使用同一个驱动芯片（如常见的TMC2209）控制两个电机，驱动器的细分微步电流、散热导致的性能漂移也会有极其微小的差别。长时间运行后，这种差异可能累积成可观的步数误差。
3. 负载分布不均：打印头、挤出机、线材的重量并非绝对均匀地分布在X轴横梁上。如果重心稍微偏向一侧，在Z轴升降启动和停止的瞬间，两侧受到的阻力矩不同，也可能导致短暂的失步。
4. 回差（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 机械与电气检查清单

在开始软件校准之前，必须确保机械和电气基础是牢固的，否则校准结果会不稳定甚至损坏机器。

1. 框架稳固性：用力摇晃打印机框架，检查是否有明显的松动或晃动。特别是龙门架结构的机器，确保所有V轮与型材接触紧密，偏心螺母调整适当，既不能太松（有晃动）也不能太紧（阻力过大）。
2. Z轴运动顺畅：手动旋转Z轴电机轴（最好断电操作），感受两根丝杠的阻力是否均匀、平滑。确保丝杠清洁、润滑适当（使用专用的润滑脂，如锂基脂或PTFE脂）。
3. 电机安装与联轴器：检查两个Z电机是否安装牢固，联轴器是否紧固，并且是柔性联轴器（可以补偿少量不同轴度）。刚性联轴器对安装精度要求极高，更容易出现问题。
4. 探针精度验证：这是所有测量的基础。重复触发你的探针（例如BLTouch）10次，记录下探针报告的Z高度。其标准差应该非常小（例如小于0.01mm）。如果波动大，需要检查探针安装是否牢固，探针针杆是否弯曲，或者清理探针的感应区域。
5. 热床预热：在进行任何与高度相关的校准前，必须将热床加热到你的常用打印温度（例如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偏移校准

在运行任何自动校准前，我们需要一个尽可能好的起点。

1. 手动粗略调平：使用一张A4纸，手动将喷嘴移动到床的四个角附近，通过调整床脚螺丝，让喷嘴与床面的距离大致相同（纸张有轻微阻力）。这个过程很传统，目的是避免床面倾斜过于严重，导致后续探测时喷嘴或探针撞到床。
2. 校准探针Z偏移：这是最关键的一步，所有后续测量的准确性都基于此。
   • 将喷嘴和热床加热到工作温度。
   • 在Klipper网页界面（如Mainsail/Fluidd）或通过控制台输入命令：PROBE_CALIBRATE。
   • 打印机会自动进行一系列操作：移动到中心、探测、将喷嘴下降到探测点。
   • 此时，你使用一张纸片（或感觉器）手动测试喷嘴与床面的间隙。通过控制台的TESTZ Z=-0.1（向下）或TESTZ Z=+0.1（向上）命令来微调喷嘴高度，直到纸张有轻微的摩擦感。
   • 调整到位后，输入ACCEPT，然后输入SAVE_CONFIG保存。这个z_offset值会自动更新到你的[probe]配置中。务必确保这个值准确无误。

4.2 第二步：使用SCREWS_TILT_CALCULATE进行床面平行度粗调

现在，我们让床面与当前（可能倾斜的）X轴横梁平行。

1. 在配置文件中添加或启用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螺丝

2. 保存配置并重启Klipper。
3. 输入命令：SCREWS_TILT_CALCULATE。
4. 打印机将依次探测每个螺丝附近的位置，然后输出类似下面的结果：

   // 探测结果 // front left screw: 太紧 0.100 圈 或 太松 0.100 圈 // front right screw: 太紧 0.050 圈 或 太松 0.050 圈 // rear right screw: 基准 // rear left screw: 太松 0.075 圈 或 太紧 0.075 圈

5. 按照提示，逐个调整床脚螺丝。记住方向：“太紧”意味着你需要拧松该螺丝；“太松”意味着你需要拧紧。建议使用带刻度的旋钮或记录扳手转动的角度，进行微调。
6. 调整一轮后，再次运行SCREWS_TILT_CALCULATE。重复这个过程，直到所有螺丝的调整量都小于0.02圈（即大约“钟表盘”上7分钟的角度）。此时，床面与当前X轴横梁已经非常平行了。

4.3 第三步：执行Z_TILT_ADJUST实现双Z轴等高

床面平行度调好后，现在我们来解决X轴横梁自身的倾斜问题。

1. 确保[z_tilt]模块已正确配置并启用。
2. 输入命令：Z_TILT_ADJUST。
3. 打印机会依次移动到你在points中定义的两个点进行探测。这个过程可能会重复几次（retries），直到连续两次探测的倾斜计算结果差异小于retry_tolerance。
4. 校准完成后，Klipper会输出类似信息：// z_tilt: 已调整 (x diff=0.123, y diff=0.000, 调整了 stepper_z=+12.3, stepper_z1=-7.8)。这表示它计算出了倾斜度，并对两个Z电机应用了步数偏移补偿。
5. 必须输入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）。

1. 目视观察：打印完成后，观察整个第一层。理想的状况是，所有区域的线条都均匀、连续、紧密贴合，没有局部透光（喷嘴过高）或被刮起毛边（喷嘴过低）。
2. 手感触摸：用手指轻轻抚摸打印表面。应该感觉整体平整光滑，没有明显的“台阶感”或一边厚一边薄的感觉。
3. 千分尺测量：如果你有数显千分尺，可以在打印件的不同位置（左前、右前、左后、右后）测量其厚度。厚度差异应控制在±0.02mm以内，这已经是非常优秀的表现了。
4. 专用测试模型：可以下载一些“第一层测试”模型，它们通常包含多个小方块或同心圆，能更细致地反映床面不同区域的高度一致性。

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打印机打印质量最有效、性价比最高的投资之一。它解决的是系统性的几何误差，让后续的挤出流量校准、压力提前等高级调校有一个坚实可靠的基础平台。花上半个小时理解和操作这个过程，换来的将是无数个小时的完美第一层和令人安心的打印成功率。