CadQuery中装配体构建时零件位置偏移问题的解决方案

在三维建模过程中，使用CadQuery构建装配体时，开发者可能会遇到零件位置不符合预期的情况。本文将通过一个典型案例，分析问题原因并提供解决方案。

问题现象

用户尝试创建一个简单的盒子堆叠装配体，包含三个不同高度的盒子（50mm、30mm、10mm）。单独查看每个盒子时，尺寸和位置都正确，但在装配后却出现了五个盒子而非预期的三个，且厚度分布异常。

原始代码如下：

box0 = cq.Workplane("front").box(50,50,50)
box1 = box0.faces(">Z").workplane().box(50,50,30, combine=False)
box2 = box1.faces(">Z").workplane().box(50,50,10, combine=False)
assy = cq.Assembly()
assy.add(box0, name="0").add(box1, name="1").add(box2, name="2")

问题分析

1. 坐标系理解偏差：默认情况下，box()方法创建的立方体是中心对称的（centered=True），这意味着新创建的盒子会以工作平面为中心向两侧延伸。

2. 堆叠逻辑错误：当在已有盒子的顶面创建工作平面时，如果不指定正确的centered参数，新盒子会跨越工作平面上下对称分布，导致实际堆叠高度计算错误。

3. 视觉表现异常：由于上述原因，盒子之间的重叠区域会产生视觉上的"重复"效果，使得看起来盒子数量比实际多。

解决方案

通过设置centered=[1,1,0]参数，确保新盒子仅在XY平面居中，而在Z方向（堆叠方向）上从工作平面开始向上延伸：

box0 = cq.Workplane("front").box(50,50,50)
box1 = box0.faces(">Z").workplane().box(50,50,30, centered=[1,1,0], combine=False)
box2 = box1.faces(">Z").workplane().box(50,50,10, centered=[1,1,0], combine=False)
assy = cq.Assembly()
assy.add(box0, name="0").add(box1, name="1").add(box2, name="2")

技术要点

1. centered参数详解：

   • [1,1,1]：默认值，在所有三个轴上居中
   • [1,1,0]：仅在X和Y轴居中，Z轴从工作平面开始
   • [0,0,0]：完全不平移，从工作平面开始

2. 装配体构建最佳实践：

   • 明确每个零件的定位基准
   • 在创建工作平面时考虑后续零件的定位方式
   • 使用combine=False保持零件独立性

3. 调试技巧：

   • 分阶段可视化检查
   • 验证各零件的边界框尺寸
   • 检查工作平面的位置和方向

总结

在CadQuery中构建装配体时，正确理解和使用centered参数对于零件的准确定位至关重要。特别是在堆叠类装配体中，需要特别注意Z轴方向的定位方式。通过合理设置centered参数，可以确保零件按照预期方式排列，避免视觉上的重叠和错位问题。

对于初学者，建议在创建复杂装配体前，先用简单几何体验证定位逻辑，逐步构建完整的装配结构。这种分步验证的方法可以有效避免类似问题的发生。