offset函数使用教程：新手完成第一张作品的方法

在 OpenSCAD 中，offset() 可以把二维轮廓向外扩张或向内收缩，也可以生成带圆角的扩张轮廓。它常用于给图形加外框、制作圆角底板、调整激光切割或 3D 打印模型的轮廓。

先说明一个术语细节：OpenSCAD 把 offset() 定义为模块，不是像 sin() 那样返回数值的函数。它接收二维几何图形作为子对象，并生成处理后的二维几何图形。大家习惯说“offset 函数”，本文也沿用这个叫法，但代码和概念以 OpenSCAD 的实际语法为准。

下面从一个可直接运行的牌子模型开始，逐步说明参数含义、使用边界和常见问题。完成后，你会得到一块带圆角、穿孔和文字的薄牌，可以进一步导出为 STL。

一、offset() 适合用在哪些地方

当你已经有一个二维轮廓，想基于它构造另一个轮廓时，offset() 很有用。典型用途包括：

• 制作外边框：将图标或文字轮廓向外扩张，再与原轮廓组合，形成边框或凸起边缘。
• 生成圆角轮廓：对矩形等尖角图形使用圆角扩张，得到适合做底板的外形。
• 调整二维切割轮廓：扩张或收缩平面轮廓，以便在后续加工中预留间隙或调整外形尺寸。
• 创建二维装饰层：把文字、徽标等轮廓扩大后作为独立装饰层，再通过 linear_extrude() 转成有厚度的模型。

offset() 操作的是二维几何。它本身不会给图形增加高度，也不能直接用来偏移一个三维实体的表面。要得到三维模型，通常要先对二维图形使用 offset()，再用 linear_extrude() 拉伸。

二、准备环境与基本操作

本文示例使用 OpenSCAD。安装后新建一个文件，把代码粘贴到编辑器中，按 F5 预览；预览正常后按 F6 完整渲染。模型确认无误后，可以通过菜单导出 STL。不同版本的菜单名称可能略有不同。

最简单的结构如下：

offset(r=2)
    square([20, 10]);

这里 square() 生成二维正方形，offset() 对它进行轮廓扩张。由于设置了 r=2，扩张产生的转角会被圆滑处理。注意，OpenSCAD 的模块语法是把子对象写在模块后面；不能把它当作数值表达式写成 my_shape = offset(...)。

三、理解两种参数模式

offset() 常用两种互斥的参数模式：r 和 delta。一次调用选择其中一种即可，不要同时传入。

1. 使用 r：圆角扩张或收缩

offset(r=3)
    square([30, 20]);

r 指定圆弧扩张的半径。正值通常使外轮廓向外扩张，并在拐角处形成圆弧；负值通常使轮廓向内收缩。正值为 3 时，矩形的外接尺寸不再是原来的 30 × 20，而会因扩张而变大。对于规则矩形，可把结果大致理解为在四周增加 3 个单位，并对角部作圆滑处理。

r 模式适合圆角外形，但结果取决于原轮廓的几何结构。负半径收缩可能让窄区域消失，也可能使复杂轮廓断开；这不是程序异常，而是收缩后几何上确实没有足够空间。

2. 使用 delta：按距离扩张或收缩

offset(delta=3)
    square([30, 20]);

delta 表示轮廓偏移的距离。正值一般向外扩张，负值一般向内收缩。它与 r 模式的区别是，delta 模式可以通过 chamfer 控制外角处理方式：

offset(delta=3, chamfer=true)
    square([30, 20]);

chamfer=true 会用倒角处理相关拐角；不设置时使用默认值。倒角和圆角是不同的几何效果。若目标是圆弧过渡，优先考虑 r 模式；若目标是按偏移距离调整轮廓并选择直线倒角，可使用 delta 模式。

参数单位由模型使用的单位决定。OpenSCAD 本身不会强制采用毫米；但在 3D 打印场景中，通常会按毫米设计，并在导出和切片时保持一致。

四、从零完成第一件作品：圆角挂牌

下面制作一个简单的挂牌：底板采用圆角矩形，左侧开一个挂孔，正面凸起显示文字。代码使用 OpenSCAD 自带的基本几何操作，不依赖图片或外部模型文件。

$fn = 48;

// 圆角矩形：通过扩张一个缩小后的正方形得到目标外形
module rounded_rect(width, height, radius) {
    offset(r=radius)
        square(
            [width - 2 * radius, height - 2 * radius],
            center=true
        );
}

// 底板和挂孔
module plate() {
    linear_extrude(height=3)
        difference() {
            rounded_rect(70, 38, 4);

            // 圆孔中心在底板左侧
            translate([-27, 0])
                circle(d=5);
        }
}

// 牌面凸起文字
module label() {
    translate([-10, -3, 3])
        linear_extrude(height=0.6)
            text(
                "HELLO",
                size=8,
                halign="center",
                valign="center"
            );
}

plate();
label();

运行后你会看到一个长方形牌子，边角经过圆滑处理，左侧有一个圆孔，文字位于牌面上方。这里的 $fn = 48 用于控制圆形等曲线的细分程度；数字越大，曲线显示通常越平滑，但复杂模型的预览和渲染也可能变慢。对于这个小模型，48 是方便观察的设置，不是所有作品都必须使用的固定值。

逐段理解代码

第一段定义了可重复调用的模块 rounded_rect()。外形尺寸为 70 × 38，圆角半径为 4，因此先生成一个尺寸为 70 - 2 × 4、38 - 2 × 4 的正方形轮廓，再以半径 4 向外偏移。这样得到的外接尺寸正好是 70 × 38。

这里的计算是针对这个简单矩形构造方式而言，不代表任意输入都能得到有效结果。例如，当 radius 等于或大于宽度、高度的一半时，内部正方形会变成零尺寸或负尺寸，模型就不符合预期。实际使用时，应让半径大于零，并小于宽、高的一半。

plate() 先用 difference() 从底板轮廓中减去一个圆孔，再把结果拉伸 3 个单位。减法操作中，第一个子对象是保留的主体，后续子对象会从主体中扣除。孔的位置由 translate([-27, 0]) 控制；圆孔直径由 circle(d=5) 控制。

label() 则把文字放在底板上表面。底板高度是 3，所以文字从 Z 轴高度 3 开始拉伸 0.6，形成贴在表面的凸字。文字的实际宽度和外观取决于系统可用字体，OpenSCAD 找不到字体时可能显示替代字体或提示相关问题；若需要稳定的生产文件，应在目标机器上确认字体，必要时将文字转成轮廓再处理。

五、让参数更容易修改

初学者常把尺寸写散在代码里，改模型时容易漏改。可以把常用尺寸集中到文件开头：

$fn = 48;

plate_width = 70;
plate_height = 38;
corner_radius = 4;
plate_thickness = 3;
hole_diameter = 5;

module rounded_rect(width, height, radius) {
    offset(r=radius)
        square(
            [width - 2 * radius, height - 2 * radius],
            center=true
        );
}

linear_extrude(height=plate_thickness)
difference() {
    rounded_rect(plate_width, plate_height, corner_radius);

    translate([-plate_width / 2 + 8, 0])
        circle(d=hole_diameter);
}

这个版本只构造底板和孔，适合先练习尺寸调整。将 plate_width 改为 80，牌子会变宽；将 hole_diameter 改为 6，孔会变大。孔中心的位置使用 -plate_width / 2 + 8 计算，可以让它随着底板宽度变化而保持在左边缘附近。

参数集中后，仍要检查它们之间的关系。比如孔不能太靠近边缘，否则孔壁会变得很薄；圆角半径不能超过矩形尺寸的合理范围；文字也不能大到超出底板。OpenSCAD 不会自动替你判断成品是否适合打印或实际使用。

六、关键边界：什么情况下结果会变样

1. offset 的对象应是二维几何

offset() 处理的是二维轮廓。最常见的子对象包括 square()、circle()、polygon()、text()，以及由二维布尔运算构造的图形。若把三维模型直接传给 offset()，不能得到“三维表面整体外扩”的效果。需要处理三维实体时，应考虑其他建模方式，不能把二维偏移和三维壳体生成混为一谈。

2. 偏移量过大可能改变拓扑

拓扑指轮廓中区域、孔洞和连接关系等结构。收缩一个很窄的长条，可能使它完全消失；扩张相邻区域，可能让它们连接在一起；处理带孔图形时，孔也可能缩小至消失。偏移量足够大时，结果不一定只是“原形平移了一点”。

因此，对复杂图形不要只凭参数猜结果。先用小偏移量测试，观察 F5 预览，再 F6 渲染。如果轮廓出现断裂、封闭或局部消失，应检查原图形的窄部、孔洞和相交区域。

3. 自相交或无效轮廓会带来不确定结果

自相交轮廓、重叠的边、极细的缝隙以及不规范的多边形，可能在偏移后形成难以预期的区域。复杂图形应尽量使用有效、闭合的二维轮廓，并通过预览和渲染检查结果。对外部导入的轮廓，也要先确认轮廓是否完整，不能假定任何输入都能得到可靠的偏移结果。

4. r 与 delta 不是可叠加的两种效果

r 和 delta 是两套参数模式，不应在同一个调用中同时使用。要圆角偏移就使用 r；要按距离偏移并控制倒角，就使用 delta。若需要先偏移再做其他轮廓处理，可以把模块分层组合，但每一步的几何关系都应单独检查。

5. 细分精度与模型效果相关

偏移的圆弧、原始圆形和曲线的视觉平滑程度，受曲线细分设置影响。细分不足时，圆弧可能看起来像多边形；细分过高则会增加计算负担。应根据尺寸、用途和渲染速度调整，而不是把细分值无限增大。预览平滑也不等于打印一定成功，仍需检查最小壁厚、孔径和模型是否为有效实体。

七、常见错误与排查方法

错误一：把模块写成变量表达式

// 错误思路：offset 不是返回二维对象的普通数值函数
shape = offset(r=2) square([20, 10]);

在 OpenSCAD 中，几何通常通过模块和子对象组合，而不是赋值给一个变量。正确写法是直接把子对象放在 offset() 下面：

offset(r=2)
    square([20, 10]);

错误二：同时使用 r 和 delta

不要写 offset(r=2, delta=2)。选择一种参数模式，按预期效果确定是圆角半径还是偏移距离。若不确定，可先分别运行两个最小示例对比。

错误三：圆角半径过大

在本文的 rounded_rect() 写法中，半径会参与原始正方形尺寸计算。如果半径过大，计算出的尺寸可能为零或负数。修改底板大小时，也要同步检查圆角半径。可先用较保守的数值，例如让半径明显小于较短边的一半，再逐步调整。

错误四：把二维偏移当成自动加厚

offset() 输出的仍是二维轮廓。需要实体厚度时，要用 linear_extrude() 包住偏移后的二维图形。相反，如果目标只是导出二维轮廓用于平面加工，就不应无意中加上拉伸操作。

错误五：预览看似正常，导出模型有问题

F5 是快速预览，适合检查大致形状；F6 才会进行完整渲染。准备导出前应执行完整渲染，确认没有报错，再检查模型是否封闭、孔洞是否正确、文字是否超出底板。导出 STL 后还应在切片软件中检查模型，特别是薄壁、过小孔径和彼此分离的零件。

错误六：认为尺寸单位由 OpenSCAD 自动规定

OpenSCAD 中的数值本身没有被软件强制绑定到毫米或英寸。模型作者需要自行统一单位，并在导出、切片和加工环节保持一致。若按毫米设计，建议在项目说明中明确写出尺寸单位，避免导入其他软件后比例不一致。

八、偏移距离与实际加工的关系

在数字建模中，偏移只是几何运算；它并不会自动补偿某台打印机、激光切割机或刀具的加工误差。如果想为配合件预留间隙，需要根据设备、材料、工艺和测试结果确定间隙，再通过轮廓尺寸或偏移量实现。不存在对所有设备都适用的固定偏移值。

例如，要让一个孔适配螺栓，不能只按螺栓标称直径设置孔径，然后假设结果必然吻合。打印方向、材料收缩、切片设置和设备精度都会影响实际孔径。可先打印小型测试件，测量实际效果，再调整模型。本文示例中的 5 单位孔径只是演示尺寸，不是任何紧固件的安全配合标准。

还要留意“向外扩张”和“向内收缩”对不同轮廓部分的影响。对实体外轮廓而言，扩张会增加外部尺寸；对孔洞而言，轮廓偏移可能让孔变小或消失。修改含孔模型时，建议通过简单测试图形确认具体结果，不要仅凭“正值就是孔变大”这类过度简化的说法作设计依据。

九、安全用途与能力边界

offset() 是几何建模操作，不是安全校验、加密、访问控制或漏洞防护功能。它不会检查模型能否承受载荷，也不会判断作品是否符合产品法规、机械安全要求或电气安全标准。把轮廓偏移一段距离，不能代替结构分析和实物测试。

如果作品将用于承重、儿童用品、医疗用途、车辆零件或其他有安全风险的场景，应由具备相关经验的人员评估材料、结构和制造工艺，并按适用标准验证。本文挂牌示例仅用于学习二维轮廓建模，不应直接被当作承重部件或安全认证产品。

从文件安全角度看，本文代码是普通的 OpenSCAD 几何描述，不包含网络访问、文件删除或系统命令。对来源不明的代码仍应先阅读内容再运行；特别是不要在未理解的情况下执行带有外部调用或批处理操作的脚本。这里的安全提醒不意味着 offset() 本身具有任何安全防护能力。

十、完成作品后的检查清单

• 确认 offset() 接收的是二维轮廓，而不是三维实体。
• 确认每次调用只采用 r 或 delta 一种参数模式。
• 检查偏移量与轮廓窄部、孔洞和圆角尺寸之间的关系。
• 按 F5 预览，再按 F6 完整渲染；有报错时先修复再导出。
• 确认单位约定、实际壁厚、孔径和文字位置符合使用目的。
• 如果用于制造，在切片软件中检查模型，并通过测试件验证配合尺寸。

结语

掌握 offset() 的关键，不是记住一个参数，而是分清二维轮廓、偏移方式和几何边界：r 用于圆角偏移，delta 用于按距离调整轮廓；正负方向会改变外形，而过大的偏移可能让局部消失、相连或改变孔洞。先从本文的圆角挂牌开始，调整宽度、圆角和孔径，观察预览与渲染结果，再把相同方法应用到自己的图标、标签或切割轮廓上。