CadQuery 2.x 版本更新全解析：从基础改进到重大功能升级-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01080/article/details/148553197

CadQuery 2.x 版本更新全解析：从基础改进到重大功能升级

cadquery A python parametric CAD scripting framework based on OCCT 项目地址: https://gitcode.com/gh_mirrors/ca/cadquery

前言

CadQuery 作为一款基于 Python 的参数化 CAD 建模框架，近年来经历了多次重要版本迭代。本文将从技术角度全面解析 CadQuery 2.x 系列版本的更新内容，帮助开发者理解各版本的核心改进、功能增强以及使用注意事项。

2.5.x 系列版本更新

2.5.0 版本亮点

自由函数 API 重大改进

2.5.0 版本引入了全新的自由函数 API 体系，这是对传统面向对象 API 的重要补充。开发者现在可以采用更函数式的编程风格进行建模，例如：

import cadquery as cq

# 传统面向对象方式
result = cq.Workplane().box(10, 10, 10).val()

# 新的自由函数方式
box = cq.make_box(10, 10, 10)

这种改进使得 API 更加灵活，特别适合函数式编程爱好者。

链式操作增强

新增了 filter/map/apply/sort/[]/invoke 等链式操作方法，大大提升了代码的表达能力：

result = (cq.Workplane()
          .box(10, 10, 10)
          .faces(">Z")
          .filter(lambda f: f.Area() > 50)
          .workplane()
          .hole(5))

可视化系统升级

cq.vis.show 功能得到显著增强，提供了更流畅的 3D 模型预览体验，支持更丰富的交互操作。

其他重要改进

几何处理增强：
- 新增了立方和二次贝塞尔曲线支持
- 改进了 Wire 圆角功能，支持闭合路径
- 修复了圆柱体在自定义方向下的中心点计算问题
文档系统优化：
- 自动从元数据获取文档版本
- 修正了多处文档错误
- 改进了快速入门指南
类型系统改进：
- 移除了 nptyping 依赖
- 增强了类型变量支持
Bug修复：
- 修复了无效面导致的崩溃问题
- 修正了子装配体中的变换顺序问题
- 解决了 STEP 导出时的对象去重问题

2.4.0 版本重大更新

核心架构升级

OCP/OpenCASCADE 7.7.2：
- 底层几何引擎升级带来性能提升
- 支持更多几何算法和操作
Python 3.12 支持：
- 提前适配最新 Python 版本
- 确保未来兼容性
VTK 可视化系统：
- 新增命令行模型查看功能
- 提供更专业的渲染效果

功能增强

几何操作：
- BoundBox 新增 enlarge 方法
- 并行布尔运算支持
- 改进的多截面扫描功能
导入导出：
- 装配体导出支持 ASCII 格式
- STL 导出支持非相对容差
- 增强的 DXF 导入导出
物理特性计算：
- 新增惯性矩阵功能
- 改进的质量属性计算

2.3.x 系列版本

2.3.0 主要改进

Python 3.11 官方支持：
- 完全兼容 Python 3.11 特性
- 修复版本兼容性问题
实验性功能状态：
- 约束草图仍在开发中
- 凸包功能标记为实验性
重要功能增强：
- 多边形闭合选项
- 保留面颜色的装配体导出
- DXF 多层支持
- 模糊切割/相交操作支持

2.2.0 版本突破性变化

重大架构变更

全新 Sketch API：
- 专为 2D 平面操作设计
- 更直观的绘图体验
装配约束系统：
- 新增多种约束类型
- 改进的求解器稳定性

向后不兼容变更

参数名变更：
- extrude(distance=...) → extrude(until=...)
- cutBlind(distanceToCut=...) → cutBlind(until=...)
行为修正：
- 修正 tangentAt() 方法的行为
- each 和 eachpoint 的 combine 参数默认值改为 True