连接件原理：原板件、接触板件与入刀面¶
连接件是后台建模里最底层、也最容易出错的一层。一个孔的位置差几毫米，板就装不上；原板件和接触板件选反，孔就打到了另一块板上。这一篇把 APlus 里连接件的每个字段讲透：一个连接件由哪些孔组成、每个孔属于哪块板、坐标从哪里量、旋转怎么决定从哪一面钻进去、Z 位置为什么要按板厚写公式。读完后，您打开公库里任何一个连接件，都能说出每个数字的意思，也能自己建一个新的。
先读行业篇
本文默认您已经知道三合一、二合一、木榫是什么，以及侧孔和面孔的区别。还不熟的话先读柜体怎么连：常规与隐形连接工艺。
一个连接件 = 两块板上的一组孔¶
在 APlus 里，一个连接件不是一个「五金模型」，而是一组孔的定义。打开主面板 数据管理 → 连接件管理，选中一个连接件，左侧浮动的 孔位列表 里每一行就是一个孔。比如公库里的三合一由「锁件 / 预埋粒 / 连杆」三个孔组成。
点孔位列表里的一行，右侧 开孔信息 页签显示这个孔的全部字段：
| 字段 | 可选值 / 填法 | 含义 |
|---|---|---|
| 孔名称 | 文字 | 给人看的名字，如「锁件」「连杆」。生成失败的提示里会用它指出是哪个孔 |
| 所属板件 | 原板件 / 接触板件 | 这个孔打在哪块板上，见下一节 |
| 孔形状 | 圆形 / 方形 | 圆孔用钻头打；方形孔是一个长方体的槽 |
| 尺寸 LenX / LenY / LenZ | 数字或公式 | 圆形孔：LenX 和 LenY 是直径（填成一样），LenZ 是深度；方形孔：LenX、LenY 是开口的长和宽，LenZ 是深度 |
| 位置 X / Y / Z | 数字或公式 | 孔的开口中心在哪，坐标系见后文 |
| 旋转（度）RotX / RotY / RotZ | 数字或公式 | 孔朝哪个方向钻，见后文 |
| NC路径 | 文字 | 见下方「待核对」 |
尺寸、位置、旋转的每一格后面都有一个 fx 按钮，点开可以写公式。改完点 保存修改。新添加的孔默认是：圆形、原板件、10×10×15、位置和旋转全为 0。
待核对
「NC路径」字段、基本信息里的「开孔参数」「引用参数」两个勾选项的具体作用，本文暂未核实，练习时保持默认即可。
除了孔，连接件还有 基本信息（编码、名称、连接方式、品牌、型号、规格、单位、备注）、连接件类型（五金模型路径）、附件信息 三个页签。基本信息里的「连接方式」下拉是这个连接件的类别（三合一、二合一、木榫、螺钉、铰链、滑轨、自定义），不要和「连接方式管理」里的连接方式混淆。
原板件和接触板件¶
两块板以直角相接时，一块板用端面（窄边）去顶另一块板的大面。在 APlus 里，谁是原板件由一条明确的规则决定：
判定规则
- 您在哪块板的哪条边上配了「板件五金」，这块板就是原板件，连接件沿这条边排布；
- 系统沿这条边去找贴在它上面的那块板，找到的就是接触板件；
- 连接件里每个孔的「所属板件」决定它打在原板件上还是接触板件上；
- 这条边上找不到贴着的板（比如两块板之间有缝），这条边就不打孔。
以最常见的侧夹顶底为例：顶板的左端顶在左侧板的内侧面上。如果在顶板的左边配了三合一，那么顶板是原板件、左侧板是接触板件。三合一的三个孔分到两块板上：
| 孔 | 所属板件 | 打在哪个面 | 孔的类型 |
|---|---|---|---|
| 偏心件孔（锁件） | 原板件（顶板） | 顶板的大面，靠近左端 | 面孔 |
| 连杆孔 | 原板件（顶板） | 顶板的左端面 | 侧孔 |
| 预埋件孔 | 接触板件（左侧板） | 左侧板的内侧大面 | 面孔 |
同一处接缝只在一边配
顶板和侧板这条缝，只在其中一块板上配板件五金。习惯上配在「用端面去顶」的那块板上（这里是顶板），因为侧孔要打在它的端面上。两边都配，等于把原板件和接触板件的身份给了两块板，孔的方向就会乱。
孔的坐标系：一切从原板件的这条边量起¶
这是本文最关键的一节。连接件里所有孔的 X / Y / Z，包括打在接触板件上的孔，都在同一个坐标系里写。这个坐标系贴在原板件的这条边上：
- 原点：原板件这条边上、连接方式排出来的那个位置点，落在「方向」指定的那一面上；
- X 轴：垂直于这条边，指向原板件内部。X = 33 就是从板边往板里 33mm；
- Y 轴：沿着这条边，也就是连接件排布的方向。多个孔沿板边错开时改 Y；
- Z 轴：沿原板件的厚度方向，从 Z = 0 的那一面指向另一面。哪一面是 Z = 0，由板件五金里的「方向」决定（例如顶板选「向下」时，顶板的下表面是 Z = 0）。
对照图 1 读公库三合一的数字就很好懂了：
| 孔 | 所属板件 | 直径 × 深度 | X | Z | 旋转 | 读法 |
|---|---|---|---|---|---|---|
| 锁件 | 原板件 | 12 × 14 | 33 | 0 | 全 0 | 离板边 33mm，从 Z = 0 那面往板里钻 14 |
| 连杆 | 原板件 | 8 × 33 | 0 | 9 | RotY = 90 | 从板边中间（Z = 9）往板里水平钻 33，正好钻到锁件中心 |
| 预埋粒 | 接触板件 | 5 × 10 | 0 | 9 | RotY = −90 | 从同一个点往板外钻，钻进接触板件的大面 10 |
表里的数字来自一份真实的三合一数据，只用来说明读法。您工厂的偏心件直径、离边距离、孔深，以采购的五金说明书为准。
两条可以自查的规则
- 连杆孔深 ≥ 偏心件孔的 X：连杆要钻到偏心件的位置才能被钩住。上例两者都是 33。
- 接触板件上的孔和连杆孔的 Z 相同：两个孔必须在同一条直线上，连接杆才能从一块板穿到另一块板。
孔的形状和尺寸¶
- 圆形：LenX 是直径，LenY 也填直径（和 LenX 一样），LenZ 是深度。孔位列表里显示为「尺寸：LenX × LenY × LenZ」。
- 方形：LenX × LenY 是开口的长方形，LenZ 是深度。旋转之后开口的朝向也跟着转，方形孔比圆孔多一个「横着放还是竖着放」的问题。建议先复制一个现成的方形孔改尺寸，生成五金后在模型里核对朝向。
孔深不能超过板厚
面孔的深度（LenZ）必须小于板厚，否则会打穿。常见做法是留出至少几毫米的底，具体以工厂工艺为准。侧孔（沿板面方向钻）的深度则受限于板的长度和另一侧的孔，不受板厚限制。
旋转决定入刀方向¶
「入刀面」就是钻头从板的哪个面钻进去。APlus 的连接件里没有单独的「入刀面」字段，而是用孔的位置 + 旋转来表达：
- 不旋转（RotX、RotY、RotZ 全为 0）时，孔沿 Z 轴正方向钻，也就是从 Z = 0 的那一面垂直钻进原板件。这是原板件上的面孔，比如偏心件孔。
- RotY = 90：钻孔方向转到 X 轴正方向，也就是从板边往原板件内部水平钻。这是原板件上的侧孔，比如连杆孔、木榫在原板件上的孔。
- RotY = −90：钻孔方向转到 X 轴负方向，也就是从板边往外，钻进贴着的接触板件的大面。这是接触板件上的面孔，比如预埋件孔、木榫在接触板件上的孔。
写成一张可以直接照用的对照表：
| 想打的孔 | 所属板件 | X | Z | RotY | 从哪一面钻进去（入刀面） |
|---|---|---|---|---|---|
| 原板件大面上、离边一段距离的面孔 | 原板件 | 离边距离 | 0 | 0 | 原板件 Z = 0 的那一面 |
| 原板件端面上的侧孔 | 原板件 | 0 | 板厚中间 | 90 | 原板件的这条端面 |
| 接触板件大面上、对着侧孔的面孔 | 接触板件 | 0 | 与侧孔相同 | −90 | 接触板件贴着原板件的那一面 |
RotX 和 RotZ 在常规连接件里一般保持 0。需要让孔绕板厚方向转一个角度（比如方形孔换个朝向）时才会用到 RotZ。
偏心件孔在哪一面，看板件五金的「方向」
偏心件孔（Z = 0、不旋转）总是打在 Z = 0 的那一面上，而哪一面是 Z = 0，由板件五金的「方向」决定。比如顶板选「向下」，偏心件孔就在顶板的下表面（柜子里面，从外面看不到）；底板一般选「向上」，偏心件孔在底板的上表面。连接件本身不用改，换一个方向就换了入刀面。这就是「旋转与入刀面的关系」：连接件里的旋转决定孔相对于这块板怎么钻，板件五金的方向决定这块板哪一面朝上。
Z 为什么要写公式¶
侧孔要打在板厚的正中间，两边留的肉一样厚，才不容易崩边，两块板装起来也平。18 的板，中间就是 9。如果 Z 直接写死成 9：
- 用在 18 的板上，正好在中间；
- 换成 16 的板，孔离一面 9、离另一面 7，偏了；
- 换成 12 的板，孔离一面 9、离另一面只剩 3，基本会崩。
所以 Z 要写成公式。行业里常用的一条规则是：
侧孔 Z 位置规则
- 板厚小于 18 时，Z 取板厚的一半；
- 板厚大于或等于 18 时，Z 取 9。
在其他软件里常写成条件式 bh<18?bh/2:9。在 APlus 的连接件孔位里，请写成：
两种写法结果完全相同：板厚小于 18 时 bh/2 小于 9，取 bh/2；板厚大于或等于 18 时 bh/2 大于或等于 9，取 9。
为什么厚板不继续取一半？常见的解释是：厚板上的偏心件和连接杆规格不变，它们咬合的位置离板面的距离是固定的，所以孔中心固定在离 Z = 0 那一面 9mm 处，不再跟着板厚走。这是常见工艺口径，具体以您使用的五金说明书为准。
验算一遍：
| 板厚 bh | min(bh/2, 9) |
孔离另一面 |
|---|---|---|
| 9 | 4.5 | 4.5 |
| 12 | 6 | 6 |
| 16 | 8 | 8 |
| 18 | 9 | 9 |
| 25 | 9 | 16 |
公式里的 bh 是哪块板的厚度¶
裸写 bh，取的是这个孔所属那块板的厚度：「所属板件」是原板件，就是原板件的厚度；是接触板件，就是接触板件的厚度。要指定取哪一块，可以加前缀：
| 写法 | 取谁的值 |
|---|---|
bh |
这个孔所属板件的板厚 |
original.bh |
原板件的板厚 |
contact.bh |
接触板件的板厚 |
cabinet.bh |
柜体的板厚变量；同理 cabinet.k、cabinet.g、cabinet.s 是柜宽、柜高、柜深 |
connector.变量引用名，或直接写引用名 |
这个连接件自己的变量（在连接件管理左侧 变量 页签里建） |
接触板件上的孔，Z 要跟原板件走
Z 轴是原板件的厚度方向。接触板件上的预埋件孔要和原板件的连杆孔对齐，它的 Z 应该按原板件的板厚算，写 min(original.bh/2, 9)。如果写成裸的 min(bh/2, 9)，取的是接触板件自己的厚度：两块板一样厚时看不出问题，一旦顶板 25、侧板 18，两个孔就错开了。
孔位公式能写什么¶
连接件孔位里的公式，目前支持：
- 数字和小数；
- 四则运算
+ - * /和括号( )； - 函数
min(...)、max(...)、abs(x)、round(x)、floor(x)、ceil(x)（大小写都可以；round这里只取整，不支持第二个参数）； - 上一节表里的变量写法。
不支持条件判断：IF(...)、? :、>、<、== 这类写法在孔位里算不出来。需要「小于多少取什么」的逻辑时，用 min / max 改写，比如上面的 min(bh/2, 9)。
待核对
孔位公式的 fx 编辑器里的函数说明，目前也列出了 IF、比较运算和三元运算，但按当前版本的实际计算规则，这些写法用在孔位上会导致生成失败。以本文列出的范围为准，后续版本若扩展了支持范围，以更新日志为准。另外，编辑器里不会算出孔位公式的结果（孔位公式要到生成五金时，拿真实的板和柜子才能算），连接件页面里的 3D 预览也不代表公式算出来的位置，请以生成五金后的实际孔位为准。
孔位公式写错时，这只柜子的生成五金会失败，提示会写明是哪个连接件、哪个孔、哪一格公式算不出来，例如「连接件「二合一-示例」……的孔「螺杆孔」，Z位置公式（z_expr）「bh<18?bh/2:9」无法计算。请在连接件管理中打开该连接件，检查该孔的公式及引用变量」。照提示回到连接件管理改那一格即可。
变量引用名的写法
给连接件建变量时，引用名只用英文字母、数字和下划线，比如 wj_ymzj（预埋直径）。不要用减号：wj-ymzj 会被当成 wj 减 ymzj，找不到变量就算不出来。
做错了会怎样¶
| 现象 | 原因 | 改法 |
|---|---|---|
| 预埋件孔打在了顶板上，侧板上没有孔 | 预埋件孔的「所属板件」选成了原板件 | 改成接触板件 |
| 连杆孔从板边往外钻，钻进了侧板 | 连杆孔的 RotY 写成了 −90 | 原板件的侧孔用 RotY = 90 |
| 偏心件孔打在柜子外面看得见的一面 | 板件五金的「方向」选反 | 顶板一般选「向下」、底板选「向上」，以工厂习惯为准 |
| 偏心件孔直接打穿 | 偏心件孔深度 ≥ 板厚 | 孔深按五金说明书，小于板厚 |
| 连接杆装不进去，钩不住 | 连杆孔深度小于偏心件孔的 X | 连杆孔深 ≥ 偏心件离边距离 |
| 16 或 25 的板，侧孔不在中间 | Z 写死成 9 | 改成 min(bh/2, 9) |
| 顶板 25、侧板 18 时，预埋件孔和连杆孔错开 | 接触板件孔的 Z 用了裸 bh |
改成 min(original.bh/2, 9) |
| 生成五金失败，提示某个孔的公式无法计算 | 孔位公式用了 IF、?:、比较运算，或引用了不存在的变量、带减号的变量名 |
按「孔位公式能写什么」改写 |
| 某条边完全没有孔 | 这条边上找不到贴着的板，或没配板件五金 | 检查两块板是否真正接触、板件五金是否配了这条边 |
自测¶
- 说出判定原板件、接触板件的规则：在哪块板的边上配了板件五金，哪块就是原板件；
- 说出连接件坐标系的原点、X、Y、Z 各指向哪里；
- 看到「RotY = 90」「RotY = −90」「旋转全 0」，说出孔分别从哪一面钻进哪块板；
- 写出侧孔 Z 的公式
min(bh/2, 9)，并验算 12、18、25 三种板厚的结果； - 说出接触板件上的孔为什么要写
original.bh而不是bh； - 说出孔位公式里哪些写法不能用。
常见问题¶
Y 什么时候不是 0？
一个连接件在同一个排布点上要打几个沿板边错开的孔时。比如有的连接件在接触板件上打两个定位孔，一个 Y = 16、一个 Y = −16，就是在排布点两侧各 16mm。
木榫怎么建？
木榫是两个孔：原板件上一个侧孔（X = 0、Z = 板厚中间、RotY = 90），接触板件上一个面孔（X = 0、Z 与侧孔相同、RotY = −90）。两个孔的深度之和要比木榫长度稍大一点，否则板合不拢。直径和长度以您采购的木榫为准。
连接件改了，已经生成过五金的柜子会变吗？
不会自动变。要对这些柜子重新点一次「生成五金」。改之前先想清楚有多少柜子在用这个连接件；拿不准时复制一份新的改。
下一步¶
- 动手做一个二合一连接件——照着本文的规则，自己建一个并配到柜子上验证；
- 连接方式：区间与排布公式——连接件沿板边排几个、排在哪；
- 连接方式与连接件——界面操作速查。