PyCATIA 完整入门指南：如何用 Python 实现 CATIA 自动化，把 3 小时的手工操作压缩到 3 分钟

PyCATIA 完整入门指南：如何用 Python 实现 CATIA 自动化，把 3 小时的手工操作压缩到 3 分钟

【免费下载链接】pycatiapython module for CATIA V5 automation项目地址: https://gitcode.com/gh_mirrors/py/pycatia

PyCATIA 是一款面向 CATIA 自动化的开源 Python 模块，它把 CATIA V5 的 COM 接口包装成顺手好用的 Python 类，让你能用几十行脚本替代数小时的手工重复操作。这篇 PyCATIA 入门文章会从连接会话讲起，带你完成几何特征识别、批量创建曲面法线等典型任务，并给出一条可以直接照做的操作路径。

一、那个盯着屏幕发呆的下午

前两年接了一个机翼曲面分析的小活，工作内容听起来很简单：在曲面上均匀布置 200 个采样点，逐个算出法线方向，再沿着法线拉出直线。

听起来简单，做起来要命。我打开 CATIA，选中曲面，右键新建点，填参数，确认；再选中曲面，再新建点……到第 40 个点的时候，我的眼神已经涣散了。更要命的是，每新建一个点，CATIA 都会自动给它起个"点.41""点.42"这样的名字，后续做分析根本对不上号，还得回头手动改名。

那个下午我干了三件事：建点、算法线、改名字。临到下班，发现第 87 个点的法线方向明显偏了——手工点选时手一抖，选错了参考面。整批数据作废，第二天重来。

如果你也经历过类似的场景，那这篇文章就是写给你的。

二、手工操作为什么总在坑你

先别急着说"我手快，能行"。把大家踩过的坑摊开看，问题其实出在四个环节上：

环节	手工操作的真实样子	典型后果
特征识别	靠眼睛在几百个几何体里找目标	选错对象、点错特征，返工率极高
批量操作	同一动作重复上百次	几个小时悄无声息地溜走
命名规范	全凭个人发挥	文件名、特征名五花八门，无法追溯
数据一致性	坐标靠手输、参考靠手选	一个数错了，下游分析全盘皆输

这四个环节恰恰是代码最擅长的事：识别靠规则、重复靠循环、命名靠模板、一致性靠逻辑。换句话说，凡是重复超过三次的操作，都值得写成脚本。

三、PyCATIA 是什么：给 CATIA 装一根 Python 指挥棒

PyCATIA 本质上是一个"翻译层"。CATIA V5 自己带了一套 COM 自动化接口，功能很全，但调用方式繁琐，参数类型绕来绕去。PyCATIA 把这些接口重新包装成符合 Python 习惯的类和方法，于是你不需要再和 COM 底层细节纠缠，只需要按 Python 的方式思考。

它的使用前提并不苛刻：

• Python 3.9 及以上版本
• 一台装着 CATIA V5 的 Windows 电脑（且 CATIA 需要处于运行状态）
• 用pip install pycatia完成安装

装好之后，你的脑海里只需要装下一条调用链：应用程序 → 文档 → 零件 → 几何集 → 几何特征。后面的所有操作，都是沿着这条链往下走。

四、三个高频操作，读懂 PyCATIA 的套路

很多新手对着 API 文档发怵，其实日常用得最多的就三招：连接、识别、批量创建。把这三点吃透，大部分自动化需求都能拼出来。

第一招：连接会话，一切从 catia() 开始

写任何脚本的第一步，都是让 Python 和正在运行的 CATIA 接上头：

from pycatia import catia application = catia() # 连接正在运行的 CATIA V5 documents = application.documents # 拿到文档集合 part_document = documents.add('Part') # 新建一个零件文档 part = part_document.part # 拿到零件对象，后续全靠它

注意documents.add()里可以传'Part'、'Product'或'Drawing'，分别对应零件、产品与工程图三种文档类型。

第二招：几何特征识别，让脚本自己分清点、线、面

CATIA 里一个几何集可能混着点、线、面、曲线，肉眼区分容易出错。PyCATIA 提供了一个判断方法——get_geometrical_feature_type()，它会返回一个类型编号，例如 1 代表点：

hsf = part.hybrid_shape_factory for shape in points_body.hybrid_shapes: ref = part.create_reference_from_object(shape) # 先转成引用 # 返回的特征类型编号为 1，说明这是一个点 if hsf.get_geometrical_feature_type(ref) == 1: print(shape.name, '是一个点')

这招在做特征筛选时特别管用：先按类型把几何体分门别类，再决定对哪一类动手，从源头避免"选错对象"。

第三招：批量创建，以"曲面法线"为例

识别出曲面和点之后，批量建法线就是一段循环的事。PyCATIA 里有个现成方法add_new_line_normal()，给定曲面、点以及起止偏移量，一条法线直线就出来了：

new_line = hsf.add_new_line_normal( surface, # 目标曲面 point_ref, # 曲面上的点 -20, 20, # 起止偏移，决定线的长度和朝向 False, ) lines_body.append_hybrid_shape(new_line) # 收进新建的几何集

把这段代码放进for循环，200 个点的法线批量生成，名字统一按NormalLine_001的规则命名。上一次花掉半天的活儿，这次从建集到出结果不到一分钟。

💡 小提示：可以把"创建几何集 → 批量建特征 → 重命名 → 更新"封装成函数，换一个曲面就能复用，积累成自己的工具库。

踩坑实录：新手最容易翻车的三个地方

• CATIA 必须提前开着。catia()连接的是正在运行的实例，CATIA 没启动，脚本直接报错，并不会帮你把软件拉起来。
• 枚举值随版本浮动。get_geometrical_feature_type()返回的数字在不同 CATIA 版本里可能有差异，第一次使用前先打印确认，别想当然。
• 老版本接口静默失效。某些新版本才引入的方法，在老版本上可能没有提示地失败。PyCATIA 提供了release_check()工具，可以在脚本里主动检查版本并给出提示。

五、三步落地：跑通你的第一个 CATIA Python 脚本

光看不动手永远学不会。下面这条路径照着走，十分钟内就能看到脚本在 CATIA 里干活。

第 1 步：准备环境

确保 CATIA V5 已经打开并处于运行状态，再打开一个终端，激活安装了 pycatia 的 Python 环境。

第 2 步：把下面这段脚本存成 rename_points.py

假设当前零件里有一个名为Points的几何集，里面混着点和其他几何，这段脚本只挑出点并重新编号：

from pycatia import catia application = catia() # 连接 CATIA part = application.active_document.part hsf = part.hybrid_shape_factory # 拿到名为 Points 的几何集 points_body = part.hybrid_bodies.item("Points") seq = 1 for shape in points_body.hybrid_shapes: ref = part.create_reference_from_object(shape) # 特征类型为 1 才表示点，避免误伤线或面 if hsf.get_geometrical_feature_type(ref) == 1: shape.name = f"Point.{seq}" seq += 1 part.update() # 让改动在模型树上生效

第 3 步：运行并核对结果

在终端执行python rename_points.py，切回 CATIA 界面，你会看到Points几何集里的点已经按Point.1、Point.2的顺序整整齐齐地排好了。如果没生效，先检查几何集名字是否拼写一致，再看 CATIA 是否处于活动状态。

六、从零件到产品：PyCATIA 的更多落地场景

批量重命名和曲面法线只是冰山一角。翻一遍项目的 examples 和 user_scripts 目录，你会发现大量开箱即用的思路：

• 翼型曲面采样与气动分析：在 NACA 翼型曲面上自动布置采样点、计算法线，为压力分布计算铺路
• 工程图模板驱动：用脚本按统一模板出图，标题栏、图框不再靠人肉填写
• 参数批量管理：从 YAML 配置批量创建参数，零件族改型时一次到位
• 装配与 BOM 处理：批量导出物料清单、重命名实例，装配树一目了然
• 选择集与视觉属性：自动高亮目标特征、统一颜色，交付演示更省心

和市面上的其他做法横向比一比，PyCATIA 的位置就清楚了：

方案	上手门槛	批量处理能力	代码复用性	适合人群
纯手工操作	低	几乎为零	无	偶尔一两次的临时任务
CATIA 自带 VBA 宏	中	较强	一般	熟悉 VBA 的老工程师
PyCATIA	中低	强	高，可沉淀为工具库	想用 Python 解决问题的工程师

七、写在最后

回到开头那个下午。如果当时有人递给我 PyCATIA，我不会在工位上枯坐半天，更不会因为手抖选错参考面而整批返工。一段不到 40 行的脚本，把"建点、算法线、改名字"这三件苦差事一次性消化干净，留给我的时间去思考真正重要的问题——采样密度合不合理、法线方向对不对、后续分析怎么排。

这就是自动化最朴素的回报：把时间还给判断，把重复交给代码。

想继续深入的话，有几条现成的路线可以参考：阅读项目docs目录下的说明文档与示例页；浏览examples目录里 40 多个可直接运行的脚本；从user_scripts里挑一个贴近业务需求的脚本改造。如果希望把源码拉到本地研究，也可以执行git clone https://gitcode.com/gh_mirrors/py/pycatia。从今天起，让 CATIA 替你干活，你替设计把关。

【免费下载链接】pycatiapython module for CATIA V5 automation项目地址: https://gitcode.com/gh_mirrors/py/pycatia