简介这份 FreeCAD 中文教程翻译版面向零基础到进阶的三维建模学习者尤其适合希望用免费开源工具完成产品造型、3D 打印和建筑建模的用户。内容围绕参数化建模展开从 Windows、Mac、Linux 三平台的安装与卸载到 3D 视图导航、界面自定义与基本首选项设置再到参数对象操作、工作台使用、文件的导入导出、传统 CSG 造型与 2D 图纸绘制以及 BIM 建模、FEM 分析、Cura 与 Slic3r 切片插件、G 代码生成和 Python 脚本编写各部分都有涉及。全书按初学者的学习节奏重新编排讲解循序渐进因此比官方 wiki 更适合首次接触 FreeCAD 的读者系统通读或按需要随时查阅。压缩包内共 1 个 PDF 文件约 14.8MB带有完整目录便于在阅读器中检索章节、跳转定位。目前已有 10990 人学习下载适合作为入门读物与案头操作手册。1. 一份机翻手册值不值得读先看它把 FreeCAD 入门拆成了什么粒度装完 FreeCAD界面上几十个工作台摆在那儿多数人第一反应是去翻文档站翻两页就退出来——信息是全的但它是按词条组织的不是从零到一个可打印零件的路径。这份 FreeCAD 中文教程-翻译版本走的是相反的路把同一批内容重新排成安装、界面、视图导航、参数化建模、转网格、导出切片器、写脚本的顺序目录里直接是「1.2.2 在 3D 视图中导航」「1.2.4.2 将对象转换为网格」这种颗粒度。它的价值不在深度在路径。想系统啃原理它不是终点想在一周内把基本操作跑通、搞清楚每个工作台管什么、能让一个尺寸可改的零件导出 STL它比在文档站里自己拼路线省事。适合机械结构方向的在校生、做小批量非标件的工程师以及要给团队留一份中文上手材料的人。机翻痕迹是它最大的短板这一点后面单独说。2. 装完到能开工三平台安装路径与七项首选项配置FreeCAD 的多平台一致性做得比较彻底同一套操作在 Windows、macOS、Linux 上几乎没有差别差别全在“怎么把它装上去”和“装完默认配置对不对”这两件事上。这一步没做干净后面建模时出现的很多“玄学”问题追到最后都是首选项里某个开关。2.1 先把“参数化”这三个字吃透手册开篇讲参数化建模用的例子是一块砖砖的形状由高度、宽度、长度三个参数控制。这个例子看着简单但它决定了你后面所有的操作习惯——在 FreeCAD 里改一个零件的尺寸不是去推顶点、不是重新画一遍而是回到对象的属性表里改那三个数几何自动重建。这是它和直接建模工具最本质的分界。推顶点的工具你改一次形状下游所有引用它的装配、图纸、分析都得跟着手动修参数化建模里尺寸是对象的一部分改完重新计算下游跟着变。手册里那句“你可以把参数化对象看作从参数创建几何图形的小程序”翻译得生硬但意思是准的。选型上要想清楚如果你的活是外形雕刻、曲面造型、影视道具FreeCAD 的约束草图加实体布尔这套流程会很难受如果你的活是支架、外壳、夹具、非标连接件这类“尺寸要反复改、改完还要出图”的东西参数化才是省时间的那条路。手册基本是围绕后一种场景写的目录里的「产品设计建模」「传统造型CSG 方式」「为 3D 打印准备模型」都是这个取向。还有一点容易忽略FreeCAD 生成的数据完全归你工程文件是文本格式的脱离软件也能读出结构。对需要长期归档、交付给别人的项目来说这比文件格式闭源要踏实得多。2.2 Windows、macOS、Linux 三条安装路径Windows 是最省事的一条。下载对应位数的安装包双击接受 LGPL 许可路径保持默认一路下一步。安装器里捆绑了 Python 解释器不需要你另外配环境也不用手动设 PYTHONPATH——除非你要做很深的二次开发。装完在开始菜单里能找到。macOS 上拿到的是压缩包解开后把应用拖进 Applications 就完事。真正的坑在第一次启动系统对非应用商店来源的程序有拦截需要去系统设置里放行一次。这一步手册里提了但描述得比较含糊实际就是首次启动被挡下来之后去隐私与安全性那一栏里点允许。另外 macOS 的打包通常比另外两个平台慢几个版本社区里用 Mac 的人少这个滞后是常态。Linux 走包管理器一条命令的事# 先看发行版仓库里打包了哪个版本避免装完发现比手册旧太多 apt-cache policy freecad # 安装仓库版本跟手册里的基础操作完全够用 sudo apt install -y freecad # 验证确认可执行文件位置和实际版本 which freecad freecad --versionapt-cache policy那一步别跳过它输出的候选版本号决定了你后面会不会遇到“手册里有的按钮我没有”的情况。手册对应的是 0.16 那个年代现在仓库里普遍已经新出好几个大版本界面分组、菜单位置、工作台命名都动过。freecad --version用来确认实际跑起来的版本出问题时这个号要报给别人。如果你的发行版仓库太旧或者想跟新特性社区还维护了额外的软件源也可以自己编译。但编译 FreeCAD 的依赖链不短第一次做的人容易卡在 OpenCASCADE 相关的那几个包上不建议作为入门第一件事。2.3 首选项里七项装完就该改的配置首选项在“编辑 → 首选项”下面页面分了好几组。不同大版本的分组名字有出入但下面这七项基本都在。装完先花五分钟过一遍能省掉后面很多莫名其妙的排查。配置项建议值为什么现在就要改语言中文或保留英文中文翻译覆盖率不是 100%混着英文界面对照手册反而更容易定位启动时打开起始中心关每次启动多一次点击长期用是纯损耗启动时自动创建文档开省掉每次新建文档的动作配合上一条刚好保存恢复信息间隔510 分钟FreeCAD 复杂模型会崩这是唯一的后悔药创作与许可按团队规范填默认值新文件自动带上省得交付时被追问将 Python 消息重定向到报告视图开脚本报错时唯一能看到堆栈的地方默认单位MKS毫米-千克-秒手册所有尺寸例子都是毫米中途换单位会出 1000 倍的错语言那一条值得多说一句。很多人装完第一件事就是切中文切完发现某些菜单还是英文以为是没装好。实际是翻译没覆盖到这些位置会直接回落成英文原文。对这种半中半英的界面我的习惯是保留英文界面 手边放这份中文手册术语对得上搜报错也方便。要给不熟悉英文的同事用再切中文。单位那一条是血泪经验。FreeCAD 内部按你设的单位解释输入的数字STL 文件本身不带单位信息切片器默认按毫米读。如果你在 FreeCAD 里用的是米导出的模型到切片器里就是 1000 倍大或者 0.001 倍小切片器会直接告诉你“模型超出打印范围”。改单位这件事开工前定死别中途改。2.4 稳定版和免安装开发版怎么选Windows 上的开发版是压缩包形式解开双击里面的可执行文件就能跑不需要安装也不覆盖已装的稳定版。这个设计挺实用——你可以同时留着稳定版跟手册学再用免安装版试新功能两个互不干扰。但配置是共享的。同一个用户下的首选项、插件目录、最近文件列表两个版本都读同一份。版本差异大的时候这份共享配置会变成黑匣子稳定版里好好的设置到开发版里可能被解释成别的意思反过来也一样。真要并行用我一般会给开发版单独指定一个用户配置目录启动参数里带上就行。Linux 上社区维护的软件源同时提供稳定版和每日构建装哪个取决于你要不要踩新功能的坑。macOS 的打包滞后追新基本只能自己编译。选择逻辑其实很简单照着这份手册学用稳定版等你能独立判断某个报错是新功能引入的还是自己操作错了再去碰开发版。顺序反了出问题时你分不清是哪一边的责任。3. 工作台、3D 视图与对象树把目录词条还原成手上的动作手册目录里有一句「所有工作台一目了然」机翻得很轻巧实际是新手最容易迷路的地方。FreeCAD 不是一个功能全塞在菜单栏里的软件它是把工具按用途拆成一组组工作台你当前在哪个工作台决定了你能看到哪些按钮。找不到工具九成是工作台没切对。3.1 工作台到底是怎么切分的工作台可以理解成“工具集包”。建模相关的有 Part基本体加布尔运算、Part Design草图约束加实体特征、Sketcher画约束草图跟输出相关的有 Mesh网格处理、TechDraw出 2D 工程图跟专业方向相关的有 FEM有限元分析、BIM建筑信息模型也就是老版本的 Arch、Path生成加工刀路还有 Spreadsheet电子表格驱动参数、Draft二维绘图与阵列、Points、Inspection 这些辅助的。切换方式在工具栏上的一个下拉框也可以在菜单里选。手册里「1.2.3.3 产品设计建模」「1.4.1.2 BIM 建模」这些章节本质都是在讲某个工作台里的一条完整工作流。新手最常见的误用是在 Part Design 里找布尔运算或者在 Part 里找草图约束。这两套东西的分工是Sketcher 画二维轮廓并加几何约束和尺寸约束Part Design 把草图变成三维特征拉伸、旋转、挖槽并管理成一个 BodyPart 做的是基本体之间的加减交。搞混了不是操作问题是心智模型问题。刚上手时我建议把工作台下拉框里用不到的项隐藏掉只留 Part、Part Design、Sketcher、Mesh、Spreadsheet 这五个。工具栏清爽了找东西的速度会明显快一截。等要做分析或者出图再把对应的加回来。3.2 3D 视图导航转不动不等于软件坏了视图导航是最先要练熟的动作因为它决定了你建模时的手感。FreeCAD 支持好几种导航样式在“编辑 → 首选项 → 显示 → 3D 导航”里选。不同样式的键位映射差别很大有的样式滚轮是缩放、按住中键拖动是平移、中键配合另一个键是旋转有的样式把旋转绑在左键上跟主流三维软件的习惯反着来。从别的软件转过来的人第一反应往往是“这软件怎么转不动”。实际上大概率是导航样式没选对不是你操作有问题。首选项那个页面里会显示当前样式的键位示意图照着图对一遍比在网上翻帖子快。几个必须记住的视图操作视图菜单里有标准视图前、上、右、等轴测缩放到适合窗口的快捷键基本是每个建模动作之后都要按一次的。模型树里双击一个对象视图会自动缩放到它——这个动作在零件多的时候特别有用比手动滚轮找半天强。还有一点视图旋转的旋转中心默认是屏幕中心不是选中对象。如果你的模型被转到画面外不是丢了按一下缩放到适合窗口就回来了。这个“以为模型丢了”的惊慌几乎每个新手都经历过一次。3.3 对象树与属性表Data 和 View 是两回事组合视图左侧是模型树右侧是属性表。属性表上面有两个标签页一个叫 Data一个叫 View。这两个标签页的区别是 FreeCAD 里最值得早点搞清楚的一件事。Data 页里是几何参数。拿一个立方体举例里面会有 Length、Width、Height 三个长度参数还有一个 Placement展开是位置、旋转轴、旋转角度。这些数改了几何真的会变。View 页里是显示参数。颜色、透明度、线宽、是否可见、显示模式线框/着色/平面。改了这些几何一点没变只是看起来不一样。新手把这两页搞混会出很典型的操作想改零件尺寸结果在 View 页里翻半天找不到长度想改颜色在 Data 页里找不着。脚本里也一样几何属性直接挂对象上显示属性挂在ViewObject上import FreeCAD as App doc App.ActiveDocument obj doc.getObject(Brick) # Data 页的几何参数直接挂在对象上 print(obj.Length, obj.Width, obj.Height) # Placement位置向量、旋转轴、旋转角弧度 print(obj.Placement.Base) print(obj.Placement.Rotation.Axis) print(obj.Placement.Rotation.Angle) # View 页的显示参数挂在 ViewObject 上几何不受影响 print(obj.ViewObject.ShapeColor) print(obj.ViewObject.Visibility)这段在 Python 控制台里跑能看到两类属性的挂载位置完全不同。obj.Length能读到obj.ShapeColor读到的是AttributeError得走obj.ViewObject.ShapeColor。这个区别在写脚本批处理时会反复遇到——想批量改尺寸走前者想批量改颜色走后者两边的 API 不通用。提示模型树里的对象名Name和标签Label不是一回事。Name 是内部唯一标识脚本里用它定位Label 是显示给你看的可以重复、可以带中文。脚本报“找不到对象”先确认你用的是 Name 不是 Label。3.4 自定义界面的边界手册里「1.2.4.1 自定义界面」讲的是工具栏、菜单、快捷键的定制。这一节内容不多但对长期使用影响不小。我的做法是等操作熟练到某个动作一天要重复几十次再去给它配快捷键。提前把快捷键表全配一遍记不住等于白配。工具栏同理用不到的工作台先隐藏等真的开始做分析、出图再按需加回来。界面布局是可以保存的。多显示器的人会把模型树单独拖到副屏这个布局保存下来下次启动还在。团队里如果有人要共用一台工作站每个人存一份自己的布局比互相迁就强。4. 从 CSG 到 STL参数化建模、转网格与切片器对接的完整链路手册把建模分成了两条路一条是「传统造型CSG 方式」一条是草图约束加实体特征。这两条路不是新旧替代关系是两种不同颗粒度的工具很多时候一个零件要两条路混着用。而所有路的终点都指向同一件事把实体转成三角网格交给切片器。4.1 CSG 和草图约束什么时候用哪个CSG 是 Constructive Solid Geometry 的缩写做法是拿基本体立方体、圆柱、球、圆锥、圆环做并集、差集、交集。手册里「1.2.3.2 选择对象」「传统造型CSG 方式」讲的就是这套。草图约束是另一条在草图里画二维轮廓加几何约束水平、垂直、相切、同心和尺寸约束把轮廓完全约束住再拉伸、旋转、扫掠成实体。两条路的对比大致是这样维度CSGPart 工作台草图约束Part Design上手速度快几个基本体一拼就出形状慢要理解约束和自由度改尺寸改属性表里的数值即可改草图里的尺寸约束重建整条特征链复杂轮廓难做靠基本体切出来很别扭强项任意轮廓都能约束下游影响特征之间独立改一个不牵连特征有父子关系改上游会传导典型用途快速验证体积、做简单支架、教学演示有明确尺寸要求、需要反复迭代的零件实际做的时候我的习惯是先用 CSG 搭一个粗形状确认整体比例和装配关系没问题再换成草图约束重做一遍把关键尺寸约束住。反过来的顺序也行但先做粗的能省掉很多“约束加完了发现方向就不对”的返工。有个细节要注意Part Design 里一个 Body 内部的特征是有顺序的后面的特征基于前面的结果。删掉中间某个特征后面全部报错。所以在 Body 里做实验之前先存一份。CSG 没这个问题基本体之间是平级的删一个不影响别的。4.2 转网格为什么 STL 导出前必须有这一步FreeCAD 里的实体是精确几何B-rep用曲面方程描述切片器要的是三角网格一堆三角形面片拼出来的近似形状。这两种表示之间不存在无损转换中间必然有一次近似。这个近似过程就是“转网格”也叫细分。近似程度由参数控制。参数给小了面片多文件大形状接近理论值给大了面片少文件小曲面会显出多边形棱角。手册里「1.2.4.2 将对象转换为网格」讲的就是这一步但机翻版没把参数含义说透。在 Python 控制台里可以精确控制这些参数import FreeCAD as App import MeshPart import Mesh doc App.ActiveDocument obj doc.getObject(Brick) # 从实体形状生成网格 mesh_data MeshPart.meshFromShape( Shapeobj.Shape, LinearDeflection0.10, # 弦高偏差单位 mm越小越贴合曲面 AngularDeflection0.50, # 角度偏差单位弧度控制相邻面片夹角 RelativeFalse # False 表示上面两个值按绝对量解释 ) # 把网格挂到一个网格对象上才能在模型树里看到并导出 mesh_obj doc.addObject(Mesh::Feature, BrickMesh) mesh_obj.Mesh mesh_data doc.recompute() # 导出 STL Mesh.export([mesh_obj], /tmp/brick.stl)LinearDeflection是弦高偏差直白说就是“允许网格偏离真实曲面的最大距离”单位跟你的文档单位一致MKS 下就是毫米。设 0.1 意味着曲面上的点到理论曲面的距离不超过 0.1 毫米。对一个 50 毫米见方的零件这个精度打印出来基本看不出差别设成 1.0圆柱面就会明显起棱。AngularDeflection控制相邻三角形之间的最大夹角单位是弧度。它主要管小半径的圆角和小孔弦高偏差在大平面上不起作用但一个直径 2 毫米的孔光靠弦高偏差控制不住得靠这个角度参数。Relative设成 True 时上面两个值会按模型尺寸的比例来解释好处是大小零件用同一套参数。我做打印件一般用 False参数跟实际物理尺寸挂钩心里有数。注意转网格之后模型树里会多出一个网格对象它跟原始实体是两个独立的东西。改了实体尺寸网格不会自动跟着变必须重新转一次。这是最容易翻车的地方——你以为改完导出就是新的实际导出的还是旧网格。4.3 对接 Slic3r 与 Cura导出参数和单位陷阱导出 STL 有两条路文件菜单里的“导出”直接选 STL 格式或者用 Mesh 工作台里的导出。两条路都会弹一个对话框问细分参数默认值往往偏粗。要精确控制就走上面那段脚本。STL 文件本身不带单位。切片器读进来的时候默认按毫米解释这意味着 FreeCAD 里如果是毫米尺寸就是对的如果文档单位是米或者英寸切片器会按毫米读模型尺寸直接差 25.4 倍或者 1000 倍。表现就是打开切片器一看模型要么小得看不见要么撑满整个打印平台还溢出。切片器这边的差别不大。Slic3r 系包括后来的衍生版本对 STL 的容错比较好模型有非流形边也能勉强切Cura 的插件可以装在 FreeCAD 里手册里「1.3.5 使用 Cura 插件」「1.3.5.2 导出到切片器」讲的就是这条路径。插件装完菜单里会多出直接发送到 Cura 的入口省掉手动导出的两步。插件装不上是常见问题排查的第一步是确认插件放对了目录# Linux插件解压到用户数据目录下的 Mod 文件夹 # 不同大版本的路径不一样先看哪个存在 ls -d ~/.local/share/FreeCAD/Mod 2/dev/null ls -d ~/.FreeCAD/Mod 2/dev/null # macOS ls -d ~/Library/Application\ Support/FreeCAD/Mod 2/dev/null两个路径分别对应新版本和旧版本。放错目录的表现是“装完了但工作台下拉框里没有”而且不会有任何报错提示纯粹静默失败。放对之后必须完全重启 FreeCAD只关窗口不算。4.4 用电子表格把参数集中管起来模型里零件一多尺寸散落在各个对象的属性表里改一个整体尺寸得挨个翻。Spreadsheet 工作台就是解决这个的建一张表把关键尺寸写进去给单元格起别名然后在模型属性里用表达式引用。做法不复杂切到 Spreadsheet 工作台新建一张表在 B 列依次写数值右键单元格设别名比如BrickLength然后回到零件的属性表在长度那一栏点右边的表达式按钮输入Spreadsheet.BrickLength。之后改表格里的数零件自动重建。这套机制的价值在装配体上体现得最明显。一个机箱的外形尺寸定在表格里内部的隔板间距、开孔位置全部引用它客户说“深度加 20”改一个格子整个模型跟着变。手工逐个改的话改漏一个就是装配干涉。代价是表达式链变长之后重建时间会上去而且某条引用断了的时候报错信息不怎么友好。所以起别名要有命名规范前缀带上零件名别全叫Length1。5. 排查清单术语歧义、网格导出与脚本报错的五类翻车现场机翻版本最大的问题不是翻错了是翻得“看着像对的”。某些词按字面理解说得通但跟界面上的英文对不上你按中文去找按钮永远找不到。这一章把术语问题和实操里最常见的五类翻车放在一起都是现象、原因、解决三段式的记录。5.1 几个容易读反的术语手册目录里有「传统的 2D 绘图」对应的其实是 Draft 工作台。Draft 这个词在机械语境里是“拔模”在这个工作台里指的是二维绘图和阵列这类操作翻成“传统的 2D 绘图”字面不算错但你在界面上下拉框里找不到这四个字得认 Draft。类似的还有「产品设计建模」对应的是 Part Design 工作台的工作流「所有工作台一目了然」是工作台总览那一节「创建参数对象」讲的是自定义参数化对象也就是用脚本定义一个带自定义属性的对象类型不是“创建带参数的对象”这么宽泛的意思。遇到这种对不上的情况我的处理办法是看英文原界面。FreeCAD 的中文翻译覆盖率不是 100%很多位置会直接显示英文这时候中英对照反而是优势——你能同时看到两种表述。真要为团队做材料我会自己在手册旁边加一列英文原词比改译文省事。5.2 五条踩坑记录第一条装完打开是半中半英以为装坏了。现象菜单里一部分是中文一部分还是英文重启也不变。原因FreeCAD 的翻译是按模块分批完成的有些模块翻译完整有些只有部分词条被翻译未覆盖的位置回落到英文原文。这不是安装问题是翻译进度问题。解决不用折腾重装。要么接受中英混排要么在首选项里切回英文界面配合这份中文手册看。要给完全不懂英文的人用就挑翻译覆盖率高的那几个工作台先教别一上来就铺全部。第二条鼠标怎么拖都转不动视图。现象模型能选中菜单能点就是视图不跟着鼠标转。原因导航样式选错了。FreeCAD 内置好几种导航方案有的方案把旋转绑在特定按键组合上跟主流三维软件的习惯完全不同。从别的软件转过来的人默认按键在这套方案里可能是平移或者什么都不做。解决编辑 → 首选项 → 显示 → 3D 导航换一个样式试试页面里会显示当前样式的键位示意图。改完立刻生效不用重启。这一条几乎每个跨软件转过来的人都踩过。第三条导出的 STL 到切片器里尺寸差 1000 倍。现象切片器里模型要么小成一个点要么大到超出打印范围。原因STL 不带单位信息切片器一律按毫米解释。FreeCAD 文档如果设成了米导出的数值就是米的数值切片器当毫米读直接差 1000 倍。解决首选项里把默认单位定成 MKS开工前定死中途不改。已经在做的文档在文档属性里改单位后重新导出。顺手在切片器里量一下已知尺寸的边确认读数对得上。第四条转完网格模型表面全是棱。现象圆柱、圆角、曲面在切片预览里明显是多边形。原因转网格时的细分参数太粗。默认值为了控制文件体积往往偏保守小尺寸零件上尤其明显。解决用MeshPart.meshFromShape手动指定LinearDeflection和AngularDeflection前者按零件精度的十分之一左右给后者给 0.3 到 0.5 弧度。改完重新生成网格对象注意原始实体改了尺寸之后必须重新转一次。第五条Python 脚本报错但控制台一片空白。现象脚本执行不下去界面上没有任何错误信息。原因默认配置下Python 的报错输出没有重定向到报告视图堆栈信息被丢掉了。解决首选项里把“将 Python 消息重定向到报告视图”和相关的错误显示选项打开。另外脚本里的相对路径是按 FreeCAD 的启动目录算的不是按文档目录读写文件一律用绝对路径能省掉一类“文件明明在却读不到”的问题。5.3 FEM 和 BIM手册给了入口没给完整链路手册目录里有「创建 FEM 分析」「1.4.1.2 BIM 建模」「生成 G 代码」这些条目但机翻版对这些模块只有目录级的描述翻到正文往往就几句话带过。这不是翻译的问题原书对这一块本来就写得浅。FEM 工作台的完整链路是建模 → 切到 FEM 工作台 → 新建分析容器 → 给材料 → 加约束和载荷 → 划分网格 → 求解 → 看结果。求解器要额外装FreeCAD 本身不带有限元求解能力它只是个前处理器。第一次用最容易卡在求解器路径没配对上报错信息也不指向具体缺什么。BIM 模块在老版本里叫 Arch新版本改名成了 BIM手册里两个名字可能混着出现。这个模块和建筑、构件、楼层这些东西绑定做机械零件的人基本用不上别因为目录里有就去啃。Path 工作台生成 G 代码前提是你已经有一套完整的机床配置和刀具库缺了这些能生成出来的 G 代码没法直接用。判断这些模块要不要碰有个简单的办法在 Python 控制台里列一下当前装了哪些工作台。import FreeCAD as App # 列出当前环境里实际可用的工作台键是内部名 for name in sorted(App.listWorkbenches().keys()): print(name)输出里没有的说明这个模块没装或者没启用去啃手册里对应的章节只会浪费时间。装了的再决定要不要深入。这一行代码我每次换机器部署完都会跑一遍几十秒的事省掉后面一堆“为什么我的菜单里没有这个”的困惑。6. 用电子表格加一行脚本做参数验证比肉眼比对可靠得多参数化模型最怕的不是建不出来是改错了不知道。尺寸改完模型树上没有报错视图里看着也像那么回事但某个内部结构已经跟外壳干涉了或者某个特征因为参数越界退化成了零体积。等你导出、切片、打完才发现料已经废了。我的做法是每次批量改参数之后跑一段验证脚本把关键对象的有效性和体积打出来。这段脚本不需要多复杂能覆盖到“这个对象还在不在、是不是变成了空壳”就够了import FreeCAD as App doc App.ActiveDocument sheet doc.getObject(Params) # 往表格里写值并起别名供表达式引用 sheet.set(B2, 160 mm) sheet.setAlias(B2, BrickLength) sheet.set(B3, 95 mm) sheet.setAlias(B3, BrickWidth) doc.recompute() # 遍历所有带几何的对象检查有效性并打印体积 for o in doc.Objects: if hasattr(o, Shape) and o.Shape.Volume 0: ok o.Shape.isValid() print(f{o.Name:14s} valid{ok!s:5s} vol{o.Shape.Volume:10.2f} mm3)set写值的时候带上单位字符串setAlias把单元格变成可被表达式引用的名字两个动作分开做。recompute是必须的不调用的话几何还停在旧状态后面读到的体积是旧值。isValid()返回 False 意味着这个形状有拓扑问题通常是自相交或者零厚度切片器那边大概率也会报错早点发现比晚发现好。体积那一列是用来对比的。改参数之前先跑一次把体积记下来改完再跑一次看变化幅度是不是符合你的预期。比如把长度从 160 改成 180体积应该涨大概 12.5%如果涨了 300%说明某个引用关系接错了改的不是你想改的那个尺寸。这套验证我一般固化成三个动作改参数、跑脚本、看体积变化。听着笨但它能在三十秒内告诉你模型是不是还活着比在三维视图里转着圈找干涉可靠得多。注意hasattr(o, Shape)这一层过滤不能省。模型树里除了实体还有草图、基准面、电子表格、网格对象它们没有Shape属性直接访问会抛异常脚本跑到一半断掉后面的对象就漏检了。从那以后我每次批量改参数不管改的是一个数还是十个都强制走一遍这段验证。有次改一个夹具的夹爪行程视图里完全看不出问题脚本一跑体积掉了 40%回头查是某个特征的引用接到了错误的表格行。要是直接导出打印那一炉料和时间就白扔了。希望帮到你。本文还有配套的精品资源点击获取
