最近在做一套图纸联动更新的小工具，需要处理一个看起来很基础、实际写代码时才发现到处是细节的需求：图纸里有两个块，它们的相对位置是固定的，其中一个块作为参考块旋转了一个角度，第二个块必须跟着变，而且要保证它和参考块之间的相对位置关系完全不变。如果只是在编辑器里手工摆两下，这事并不难；可一旦要写成程序，让几十个块通过一次操作全部跟上，就必须把位置、旋转角、旋转中心这几个概念逐个拆明白，否则很容易做出“看起来差不多、怎么都对不上”的结果。
这篇文章我会从数学定义讲起，给出一套可以直接复用的推导方法和代码框架，再分享我在实际测试中用来验证结果、排查偏差的几条经验。无论你是做CAD二次开发，还是只是在设计自动化流程中需要处理块的联动变换，这部分思路都适用。
1. 把“相对位置不变”翻译成两个数学不变量
1.1 两个块之间到底存了哪些位姿信息
很多人在刚开始处理这个问题时，会下意识地把“相对位置”理解为“相对坐标差”，也就是第二块相对第一块往右多少、往上多少。这个理解不完整。一个普通块参照在图纸里由三个最核心的位姿参数决定：插入点坐标、旋转角、以及X/Y/Z的缩放比例。对“保持相对位置”这件事来说，最容易被漏掉的就是旋转角。
假设参考块记为A，目标块记为B。两者间的相对关系，严格来说应该用两组信息共同描述：
- 位置差向量 d = PB − PA
- 角度差 da = rotB − rotA
d决定B距离A多远、在哪个方向上；da决定B自身朝向相对A差多少。只有当d和da在A旋转之后都保持不变，我们才能说两个块的相对位置没有变。很多程序出错，就是只维护了d，把da弄丢了。
1.2 一个直观实验：只动位置不动角度会发生什么
为了说清楚这个误区，我经常用一个小例子演示：假设参考块是一块方形的底座，目标块是一个带箭头的指示块，箭头指向底座右上方的某个位置。两个块原本是一个整体，箭头方向相对底座是固定的。现在让底座绕自身的插入点逆时针旋转90度，然后程序只把目标块平移到新的“相对坐标”上，完全不去碰它的旋转角。
结果是：底座转了90度，箭头还是原来那个方向。从图形上看，整个装配就像内部发生了撕裂，箭头和底座之间的相对姿态彻底变了。出现这种结果的原因，就是角度差没有被当作不变量来维护。
所以，正确的“相对位置不变”应该这样理解：
- d = PB − PA，保持向量的长度和平面方向不变；
- da = rotB − rotA，保持两个块自身的相对朝向不变。
只要这两条都满足，无论参考块转到哪里，整个组件看起来就像是被焊在一起、整体端过去一样。后面所有代码和公式，目标都是维护这两个不变量。
2. 旋转中心是分水岭：目标块必须跟着同一个基点转
2.1 把两个块看成一个刚性整体，思路立刻清晰
在CAD的实际操作中，参考块A往往不是绕着“自身插入点”旋转的，而是绕着某个装配基准点旋转——比如法兰中心、轴孔中心、某个定位销的位置。这时候B要保持相对A不变，处理办法就不能是“把B绕着A的插入点转一转”这么简单。
我在推导时发现一个更稳妥的视角：把A和B看成一个刚性组件，参考块执行旋转操作时，真正发生的物理过程是整组块绕某个旋转中心O进行了一次整体旋转。这样说可能有点反直觉，但数学上确实成立：
- A的新位置 = O + R(θ) × (A旧位置 − O)
- B的新位置 = O + R(θ) × (B旧位置 − O)
- A和B的新角度 = 各自的旧角度 + θ
这里R(θ)就是二维平面旋转矩阵。只要你把两个块当刚体处理，B的位置和角度都跟着A走，相对位置自然保持不变。
这个视角最大的好处是，它把“旋转中心”这个参数彻底显性化了。程序里必须明确传入旋转中心O和旋转角θ，而不是从参考块的当前状态里反推一个默认中心出来。
2.2 旋转中心不同，结果会差很多
我在实际开发中踩过这样一个坑：参考块是绕着外部一个定位基准点旋转的，但我写代码时想当然地让目标块绕参考块的插入点旋转，结果参考块已经转到新位置了，目标块却停在一个完全错误的地方，肉眼一看就散了。
用一个表来说明不同旋转中心下的计算结果差异会更直观。假设A在(100, 100)，B在(150, 200)，相对向量d=(50, 100)，旋转角θ=30度：
| 场景 | 旋转中心 | A旋转后位置 | B的计算结果 |
|---|---|---|---|
| 正确做法 | 外部基准点(0, 0) | (136.60, 186.60) | (205.32, 267.32) |
| 错误做法 | 参考块旧插入点(100,100) | 需要重新设定，否则按旧A中心会错 | 容易偏离预期 |
| 直接平移不旋转 | 无 | 任意 | B角度不变，相对姿态破坏 |
正确做法的计算结果是让B绕着同一个外部基准点旋转，这样B的位置实际上等于外部基准点旋转后的位置加上旋转后的相对向量。而错误做法相当于把旋转中心理解错了，位置自然就对不上。
结论很简单：如果要保持刚性的相对关系，那么目标块必须和参考块绕同一个基点、转同一个角度。只要旋转中心保持一致，相对向量是否绕A的插入点计算反而是次要的——因为数学上最终会收敛到同一个结果。
3. 推导公式与可直接抄的通用同步旋转函数
3.1 从相对向量出发，两步算出目标块新位姿
既然相对位置不变，那我就把求解过程拆成两步：
第一步，先算出参考块A旋转之后的新位置：
newRefPos = O + R(θ) × (oldRefPos − O)
第二步，把相对向量d = oldTargetPos − oldRefPos 也旋转θ：
newTargetPos = newRefPos + R(θ) × d
目标块的新角度则等于旧角度加上θ：
newTargetRot = oldTargetRot + θ
这套公式不要求参考块必须绕自身插入点旋转，因为newRefPos已经包含了参考块旋转之后的位置，而相对向量用的是旧位置之间的差值，再单独旋转一次。实际验证下来，无论旋转中心在哪里，只要A的位置是按同一个旋转中心和角度算出来的，这个公式的结果都是正确的。
如果从更严谨的角度看，这个计算其实就是在维护整个组件的变换关系。假设A和B的原始变换矩阵分别为T_A和T_B，那么相对变换矩阵M_rel = T_A⁻¹ × T_B。A更新为T_A_new之后，B的新变换矩阵就是T_B_new = T_A_new × M_rel。这个矩阵式子可以通吃旋转、平移和缩放，只是对于普通等比例缩放的块，用位置向量和角度的加减法已经足够，实现起来也更直观。
3.2 一段可以复用的通用代码
下面这段代码我建议直接复制到项目里使用。它定义了一个简单的块位姿结构，提供绕任意点旋转的函数，并返回目标块同步之后的新位姿。所有角度均使用弧度制，避免在CAD和C#的数学库之间反复换算导致的单位错误。
// 用于表示平面上的一个点的简易结构 public struct Point2d { public double X; public double Y; public Point2d(double x, double y) { X = x; Y = y; } public override string ToString() { return $"({X:F3}, {Y:F3})"; } } // 块的位姿：插入点 + 旋转角（弧度） public class BlockPose { public Point2d Position; public double Rotation; public BlockPose(Point2d position, double rotation) { Position = position; Rotation = rotation; } } public class BlockTransformHelper { // 绕任意中心旋转一个点 public static Point2d RotatePoint(Point2d point, Point2d center, double angle) { double cosA = Math.Cos(angle); double sinA = Math.Sin(angle); double dx = point.X - center.X; double dy = point.Y - center.Y; double rx = dx * cosA - dy * sinA; double ry = dx * sinA + dy * cosA; return new Point2d(center.X + rx, center.Y + ry); } // 计算保持相对位置不变时，目标块应该到达的新位姿 public static BlockPose CalculateSyncedTargetPose( BlockPose oldRefPose, BlockPose oldTargetPose, Point2d rotationCenter, double deltaRotation) { // 第 1 步：先计算参考块旋转之后的新位置 Point2d newRefPos = RotatePoint(oldRefPose.Position, rotationCenter, deltaRotation); // 第 2 步：用旧位置求相对向量 d double dx = oldTargetPose.Position.X - oldRefPose.Position.X; double dy = oldTargetPose.Position.Y - oldRefPose.Position.Y; // 第 3 步：把相对向量绕原点旋转 deltaRotation double cosA = Math.Cos(deltaRotation); double sinA = Math.Sin(deltaRotation); double newDx = dx * cosA - dy * sinA; double newDy = dx * sinA + dy * cosA; // 第 4 步：目标块新位置 = 参考块新位置 + 旋转后的相对向量 Point2d newTargetPos = new Point2d(newRefPos.X + newDx, newRefPos.Y + newDy); // 第 5 步：目标块新角度 = 旧角度 + 参考块旋转角度差 double newTargetRot = oldTargetPose.Rotation + deltaRotation; return new BlockPose(newTargetPos, newTargetRot); } }3.3 把它接入你的CAD命令调用逻辑
实际使用这套函数时，你只需要在命令入口处完成三件事：
- 从图纸中读取两个块当前的插入点和旋转角；
- 传入旋转中心与旋转角度差；
- 把计算结果写回目标块，并对参考块也执行同样的旋转。
参考代码如下：
public void SyncBlockWithReference( BlockPose oldRefPose, BlockPose oldTargetPose, Point2d rotationCenter, double deltaRotation, Action<BlockPose> setRefPose, Action<BlockPose> setTargetPose) { // 参考块自身也要按同一基点和角度旋转 Point2d newRefPos = BlockTransformHelper.RotatePoint( oldRefPose.Position, rotationCenter, deltaRotation); BlockPose newRefPose = new BlockPose(newRefPos, oldRefPose.Rotation + deltaRotation); // 目标块保持相对位置不变 BlockPose newTargetPose = BlockTransformHelper.CalculateSyncedTargetPose( oldRefPose, oldTargetPose, rotationCenter, deltaRotation); setRefPose(newRefPose); setTargetPose(newTargetPose); }这里setRefPose和setTargetPose是两个回调，你在具体CAD平台里可以直接把它们实现为“更新块参照位置与Rotation属性”的函数。之所以这样设计，是为了把数学核心和平台API隔离开，做单元测试时也不依赖图形环境。
在CAD的二次开发里，读写块参照时有两个细节非常容易踩坑：一是Rotation属性通常使用弧度，界面显示的是角度，不能混用；二是修改块参照之前必须确保它处于可写状态，否则事务提交时会报错。这些平台相关的细节，建议在接入时单独封装，不要在核心函数里混着写。
4. 用辅助线和程序输出双重验证计算结果
4.1 辅助线是最直观的验收标准
每次我在实际项目里使用这段代码之前，都会先在图纸里画一条辅助线，连接参考块的插入点和目标块的插入点，然后记录这条线的长度和方向。执行完整同步旋转之后，再画一条新辅助线，对比两条线的长度和角度差。
正确的算法应该满足两个条件：
- 新辅助线长度等于旧辅助线长度；
- 新辅助线方向等于旧辅助线方向加上旋转角度θ。
这是什么原理呢？因为在执行算法前后，两个块之间的位置向量d并没有变，变的只是整个组件被整体旋转了一次。所以任何一条连接组内两个点的线段，长度都必须保持不变，方向则整体转θ。如果新辅助线的长度变了，说明目标块被多乘或少乘了一个缩放或扭曲；如果方向差不对，说明旋转角没有加对。
我在代码联调时，就靠这个辅助线方法一次性发现了“只改位置不改角度”和“旋转中心传错”这两类问题，比盯着坐标数值硬分析效率高得多。
4.2 用程序输出做数值级验证
辅助线适合人工目检，程序化验证更适合批量回归。我会在计算前后用下面这段日志函数，把相对向量的长度和角度打印出来：
static void PrintRelativeInfo(string tag, Point2d refPos, Point2d targetPos, double deltaRotation) { double dx = targetPos.X - refPos.X; double dy = targetPos.Y - refPos.Y; double length = Math.Sqrt(dx * dx + dy * dy); double angle = Math.Atan2(dy, dx); // 这里使用Degree输出，仅用于日志展示 double angleDeg = angle * 180.0 / Math.PI; double deltaDeg = deltaRotation * 180.0 / Math.PI; Console.WriteLine($"{tag}: 长度={length:F6}, 方向角度={angleDeg:F6}, 旋转增量={deltaDeg:F6}"); }调用时，只要把计算前的参考块旧位置/目标块旧位置打一组，再把计算后的新位置打一组，人工对比“长度”和“方向角变化量”即可。对于数值稳定的情况，两条记录的长度应当小数点后六位完全一致，方向角差值应当等于传入的旋转角。
有一点需要提醒：浮点运算会带来极其微小的误差。如果依赖毫厘不差的相等判断，测试会反复报假错。实际项目中建议用误差阈值，例如长度差小于1e-6、角度差小于1e-9（弧度）时就认为验证通过。
4.3 多块批处理时的验证策略
如果图纸里有几十个块需要保持相对位置，处理方式其实没有本质变化：把它们当成同一个刚性组件，用同一个旋转中心和同一个旋转角，逐个套用CalculateSyncedTargetPose即可。这里最容易犯的错误是给每个块分别找旋转中心，比如有的块绕着组件中心转、有的块绕自己中心转，结果整个组件被拆得七零八落。
批处理验证我也有一套固定流程：
- 先对所有块记录“相对参考块的向量长度和角度差”作为基线；
- 执行批量同步旋转；
- 再对所有块重新提取同样的数据；
- 检查每个块的前后长度误差和角度差误差。
只要所有块的最大长度误差在允许范围内，且所有角度差都等于同一个θ，这次批量操作就是成功的。如果一个组件里某个块的长度误差特别大，通常不是算法问题，而是那个块的插入点被单独移动过，或者它本来就不属于这个刚性组件。
5. 四种常见错误写法，以及非等比缩放块的进阶处理
5.1 错误公式的根因分析
写这套逻辑的过程中，我自己反复犯过四类错误，后来给同事讲解时也发现它们非常有代表性。这里统一列出来，方便对照排查。
| 错误写法 | 错误原因 | 正确做法 |
|---|---|---|
| 只平移目标块位置，不更新Rotation | 角度差没有保持 | 新旋转角 = 旧旋转角 + θ |
| 目标块绕参考块插入点旋转 | 忽略了参考块的实际旋转中心 | 必须用参考块实际旋转的中心 |
| 把目标块的旋转角直接设为参考块的新旋转角 | 破坏了两个块原有的角度差 | 保持相对角度差，目标块新角 = 旧角 + θ |
| 目标块位置用旋转后的参考块位置加旧相对向量，但不旋转相对向量 | 只是平移了相对向量，没有让向量跟着旋转 | 相对向量必须乘以旋转矩阵 |
第一个错误在可视化上表现为“组件撕裂”。第二个错误在参考块绕外部基准点旋转时尤其致命，位置会大范围偏离。第三个错误的隐蔽性最强，因为如果两个块原本角度相同，结果恰好看起来正确；一旦两个块原本存在一个相对角度差，就会整体错位。第四个错误则是把“相对位置不变”简化成了“相对坐标差不变”，忽略了方向是随旋转而改变的。
5.2 非等比缩放块和嵌套块：不能只用角度加减法
前面所有公式默认块的缩放是等比例的，也就是X方向和Y方向的缩放系数相同。如果你处理的块引用带有非等比缩放，比如ScaleX=2、ScaleY=1，那么直接用Rotation属性的加减法来维护相对姿态就会失真。这是因为非等比缩放本身会改变视觉上的方向，块的Rotation属性只代表块定义坐标系里的角度，视觉角度不等于属性值。
遇到这种块，最稳妥的办法是使用完整的变换矩阵来做相对变换计算，而不是单独维护Position和Rotation两个参数：
- 读取参考块的旧变换矩阵T_A和旧目标块矩阵T_B；
- 计算相对变换矩阵M_rel = T_A⁻¹ × T_B；
- 参考块执行旋转后得到新矩阵T_A_new；
- 目标块新矩阵T_B_new = T_A_new × M_rel。
这个矩阵方法把平移、旋转、缩放全部打包在一起，不再区分Position和Rotation，也更接近CAD底层对块参照的真实表达方式。它同样适用于嵌套块等复杂结构。代价是调试时不如Position/Rotation直观，所以我的建议是：普通场景用本文的向量公式，处理完旋转后再用矩阵公式做一次交叉验证。
在实际项目中，我最后保留的是一套两层的处理逻辑：默认使用简单的位置向量加角度差公式，检测到非等比缩放块时自动切到矩阵处理。这样既能满足绝大多数图纸场景，又能在复杂情况下保持正确性。如果你也要在项目里用这套方案，建议把两种方式封装成同一个接口，避免调用方在业务逻辑里做太多区分。
