OpenSCAD

CSG 思维：代码不是画图，是做运算

OpenSCAD 不是 CAD 建模器，没有草图、没有特征树。它是一个 CSG（实体构造几何）解释器：你写的每个对象都可以用 difference() union() intersection() 组合成一个新实体。

这决定了写法上的根本差别——尺寸参数化的方式只有两种：直接给常量，或者引用 局部变量。约束驱动的建模（孔距随边长自动变化）在这里做不了，得自己在代码里算：

openscad// 参数化挂架：所有尺寸由 width 推导，改一个数整体联动
width = 60;  depth = 40;  thickness = 5;  hole_d = 4;
wall  = 8;                 // 边到孔中心的距离
// ----
module bracket() {
    difference() {
        cube([width, depth, thickness]);
        // 四个安装孔，位置随 width/depth 自动算
        for (x = [wall, width - wall])
            for (y = [wall, depth - wall])
                translate([x, y, -1])
                    cylinder(h = thickness + 2, d = hole_d, $fn = 32);
    }
}
bracket();

$fn、$fa、$fs：圆弧精度

只要用到 cylinder() 或 circle()，就必须搞清这三个特殊变量：

• $fn：固定的分段数。$fn=32 就是 32 段。
• $fa：最小角度（默认 12°）。
• $fs：最小弦长（默认 2）。

$fn 是全局的，写在后面会影响前面所有圆。局部用要自己收敛作用域——在 module 内部写 $fn = 48;，只对该 module 内的 cylinder() 生效。

漏写 $fn 是最常见的错误，表现为圆孔渲染成多边形。默认值下小圆可能只有 5~6 段，肉眼能看出棱角。

render 与 preview 的关键差异

F5 是 preview，F6 是 render，两者行为不同：

preview 下 ! 修饰符不生效，会让本该排除的调试对象参与运算，导致画面里凭空多出东西。所以预览结果和 F6 不一致时，先去掉调试用的 ! 修饰符再试。

布尔运算失败排查

difference() 出来的东西不对，排查顺序：

1. 减的对象没真正相交。两个面刚好接触（共面共边）时结果可能不可预期。技巧是把被减对象略微超出：translate([0,0,-1]) cylinder(h = height + 2, ...)。
2. $fn 不一致。被减对象和工件的圆分段数不同，边界会出现残留薄片。统一 $fn。
3. 悬空几何。用 preview 看 union() 后的形状是否连成一体。
4. minkowski 太慢。它是最慢的运算，$fn 一大就基本卡死。改成先做二维轮廓布尔再 linear_extrude() 拉伸，同样效果快一个数量级。

命令行批量导出

预览是给看的，真正要交付的是网格文件。用 -o 指定输出格式，扩展名决定导出类型：

bash# 导出 STL（3D 打印）；导出 3MF 用 -o part.3mf，可保留颜色
openscad -o part.stl part.scad
# ----
# 输出 PNG 渲染图做几何检查（需要图形环境）
openscad -o preview.png --render --camera=0,0,0,55,0,45,140 part.scad
# ----
# 用 -D 覆盖代码里的默认值，批量出不同尺寸
openscad -D width=80 -D depth=50 -o custom.stl part.scad

--render 走 F6 的真实几何计算，比默认预览慢但结果准确，批量生产时应该加上。导出的 STL 是二进制还是 ASCII 可用 --export-format 控制，二进制体积小很多。