cadquery

项目地址： https://github.com/CadQuery/cadquery

官方文档： https://cadquery.readthedocs.io/en/latest/

GUI： CQ-editor（https://github.com/CadQuery/CQ-editor）

许可证： Apache-2.0

概述

CadQuery 与 OpenSCAD 的对比：

维度	OpenSCAD	CadQuery
语言	自有 DSL	Python
几何内核	CGAL/Manifold	OCCT
模型	CSG（实体加减）	BREP（带圆角/曲面/约束）
装配	手动	内置 Assembly
特征命名	弱	通过 Selector 访问面/边/顶点
输出	STL/OFF/DXF	STEP/IGES/STL/glTF/DXF/SVG

---

安装

# Conda（推荐，自动带 OCCT）
conda install -c conda-forge cadquery
# pip
pip install cadquery
# 安装 GUI
pip install cq-editor

当前稳定版 2.8.0（GitHub Release 2026-06-20，PyPI 2026-06-21，参见 CadQuery GitHub Releases）。PyPI 包要求 Python ≥ 3.11，几何依赖 cadquery-ocp（2.8.0 锁 >=7.9.3.1,<8.0，即 OCCT 7.9.x）；conda-forge 通道同步发布。

---

Hello CadQuery

import cadquery as cq

result = (
    cq.Workplane("XY")
      .box(80, 60, 10)            # 立方体
      .faces(">Z").workplane()     # 选择 +Z 面，建立工作平面
      .hole(8)                    # 钻孔
      .edges("|Z").fillet(2)      # Z 方向边圆角 2
)

cq.exporters.export(result, "out.step")
cq.exporters.export(result, "out.stl")

---

工作平面（Workplane）

wp = cq.Workplane("XY")               # XY/YZ/XZ 或自定义
wp = (cq.Workplane("front")           # 命名平面
        .center(10, 0)                # 偏移工作平面原点
        .rotateAboutCenter((0,0,1), 30))

---

二维草图与拉伸

result = (cq.Workplane("XY")
            .moveTo(0, 0)
            .lineTo(50, 0)
            .lineTo(50, 30).lineTo(0, 30).close()
            .extrude(20))

# 圆形 → 拉伸为圆柱
cyl = cq.Workplane("XY").circle(10).extrude(50)

# 矩形阵列
plate = (cq.Workplane("XY").rect(100, 60).extrude(2)
          .faces(">Z").workplane()
          .rarray(10, 10, 8, 5).hole(3))   # 8x5 阵列孔

---

Selector（核心特性）

result = result.faces(">Z")        # 最大 Z 的面
              .edges("|X")         # 平行 X 方向的边
              .vertices("<Y")       # 最小 Y 的顶点
              .faces("not >Z and %CIRCLE")  # 复合