把 CATIA 装配体里的零件清单，一键整理到 Excel：我做了一个小插件

做机械设计的喷友，大概都遇到过这样的场景：一个装配体里面有几十、几百甚至更多零件，项目需要整理零件编号、名称、版本、材料、数量、质量和截图。信息明明都在 CATIA 里，却还要打开零件、复 制属性、切换 Excel，再一行一行填写。这种工作技术含量不高，却非常消耗时间，而且零件一多就容易漏项、抄错或者统计错数量。

于是，我给自己做了一个小工具：CATIA 零件用量清单助手（升级版）。它的目标很简单：让 CATIA 负责提供模型和属性，让插件负责统计和整理，让 Excel 负责集中查看与编辑。

一、它能导出哪些内容？打开一个 CATProduct 装配体，程序会递归读取多级装配结构，识别其中的 CATPart，并按照零件编号整理清单。

目前可以输出的主要信息包括：

- 零件编号 PartNumber- 定义 Definition- 版本 Revision- 术语 Nomenclature- 来源 Source- 材料- 密度- 外形尺寸（长×宽×高）- 表面积- 体积- 单件质量- 零件数量- 多件总质量- 零件截图- 用户选择的自定义参数.对常规装配来说，原本需要手工整理很久的信息，现在可以集中导出到一张 Excel 清单中(如下图)。

二、零件截图也可以自动放进表格。为了让清单更加直观，我在程序中加入了 CATIA 零件截图功能。这样查看清单时，不必只靠零件编号和名称判断零件，尤其适合评审、采购沟通和资料整理。外形尺寸和截图都可以根据实际需求决定是否启用。如果只需要快速统计零件编号和数量，可以关闭这些耗时项目，提高导出速度。

三、需要哪些用户自定义参数，打开用户自定义参数列表窗口后，就勾选哪些参数，最终excel清单就增加这些列。

四、Excel 编辑信息后，还可以传回 CATIA。导出只是第一步。清单中的部分单元格会用黄色底色标出，表示这些内容允许用户修改，例如：- 定义- 版本- 术语- 来源- 和已经存在于 CATIA 中的用户自定义参数,修改完成后，可以点击插件中的“Excel 表零件属性信息一键传回 CATIA”按钮，程序会把可编辑内容写回 CATIA。这对于批量统一版本、修改术语、补充自定义属性信息等工作非常方便。

五、用户自定义参数也能批量管理，除了导出和回传，我还增加了一个“用户自定义参数管理”功能。

1. 批量创建或更新字符串参数：窗体中可以预先设置 多组“参数名称 + 参数值”。执行后：根据当前窗体的用户自定义参数列表创建或者更新零件的用户自定义参数值；2. 选择性清除用户参数，用户可以在窗体中选择某些参数进行删除。

六、基本使用流程

插件目前主要面向 CATProduct 装配体，推荐按下面的步骤操作：

1. 先备份需要处理的 CATIA 文件。

2. 打开目标 CATProduct，确认下级零件引用能够正常加载。

3. 打开插件，进入零件用量清单导出窗口。

4. 选择需要输出的用户自定义参数，并决定是否计算外形尺寸、是否生成截图。

5. 点击一键导出，等待程序完成；运行期间尽量不要切换 CATIA 或点击正在写入的 Excel。

6. 检查零件数量、属性、质量、尺寸和截图是否符合预期，然后手动保存 Excel 文件。

7. 如果需要回传，只修改黄色 区域，并确认激活的是正确工作簿和正确 CATProduct。

8. 回传或批量参数操作完成后，检查结果，再手动保存被修改的 CATPart/CATProduct。