简介《FreeCAD中文教程-翻译版本》面向初次接触开源参数化3D建模的读者以及希望系统查阅FreeCAD操作流程的设计、制造与3D打印爱好者。资源包仅含1个PDF文件大小约14.8MB内容围绕官方手册展开涵盖Windows、macOS与Linux安装、界面与3D视图导航、参数化对象创建、工作台使用、导入导出、FEM分析、Cura与Slic3r插件、Python脚本、BIM建模、G代码生成及2D图纸绘制等模块。该版本为中文翻译整理章节组织较完整配有示例式讲解便于读者按安装、建模、分析到输出的顺序建立整体认识也可作为日常操作时的速查参考。目前已有10960人学习适合作为FreeCAD入门与功能检索的配套资料。1. 一本机翻手册的用法FreeCAD 中文教程值不值得先啃硬盘里躺着的那本 FreeCAD 中文教程多半是这么来的有人把官方 wiki 的内容反向整理成书再用机器翻译过一遍于是目录页码是乱的、句子语序是拧的第 1.2.4.2 节讲“将对象转换为网格”下一页却跳去讲“在 Mac 操作系统上安装”。可它依然是目前少见的一份成体系中文材料——两三百页从安装、首选项、3D 视图导航一路铺到工作台、CSG 建模、FEM 分析、Python 脚本、BIM 和 G 代码生成。它解决的不是“FreeCAD 是什么”这种问题而是“我想照着一条线把参数化建模到出 3D 打印件走完一遍但 wiki 上三百个页面我不知道先点哪个”。适合第一次接触参数化建模、手上有个具体零件想打出来的人不适合已经能熟练用草图约束、只缺某个命令查表的老手。下面按这本手册的实际章节顺序把能抄作业的部分和翻译翻车的地方一起拆开。2. 安装与首选项三条平台路线和七个改完就少踩坑的参数2.1 先对版本号再对菜单这本手册写作时对应的稳定版是 0.16而你从官网拖下来的安装包大概率比它新好几个大版本。这不影响按章节顺序学但会影响你按图索骥找菜单——手册里写“编辑 → 首选项”新版里位置没变手册里写“视图 → 工作台”新版可能已经变成下拉框加图标。我一般让新手先做一件事打开软件帮助菜单里找到“关于”把版本号抄在手册扉页上。之后凡是手册说“点某菜单”而你没找到先去帮助里搜命令名FreeCAD 的命令搜索框能直接定位到菜单路径比翻手册快。另一个错位点在翻译本身。手册正文是机翻的术语前后不统一同一段里“草图”和“略图”可能指同一个 Sketcher“实体”和“固体”都指 Solid“工作台”有时被译成“工作空间”。读的时候别跟术语较劲看到“参数对象”就知道说的是 Parametric Object看到“网格”就是 Mesh。真正要较真的是参数名和数值这些在软件界面里是英文原文机翻不会动它们。2.2 三条安装路线按平台选一条走完手册把 Windows、Linux、Mac 分成三节讲逻辑是对的因为三者安装方式差异比想象中大。Windows 上是预编译安装包双击、接受 LGPL、选路径、装完在开始菜单里找Mac 上是压缩包解压后把应用拖进 Applications第一次启动会被系统权限拦一次得去系统设置里放行Linux 上最省事直接用发行版包管理器一条命令的事。# Debian / Ubuntu 系 sudo apt update sudo apt install freecad # Fedora / CentOS 系 sudo dnf install freecad # Arch 系 sudo pacman -S freecad这段没什么玄学但要注意两点。一是包管理器里的版本通常落后于官网如果你要跟着手册后面的 Python 脚本章节练版本太老可能缺某些 API装完先看一眼版本号。二是手册提到的 PPA 和“每日构建”属于开发版渠道稳定版够用就别碰开发版崩起来是真的崩而且崩溃后恢复的文件格式偶尔和稳定版不兼容血泪经验。Windows 用户还有一个细节安装过程中会捆绑 Python 运行时手册特意提醒“不需要设置 PYTHONPATH 变量除非你打算做高级安装”。这句话翻译得别扭意思是 FreeCAD 自带 Python 解释器不要拿系统里另装的 Python 去指它否则脚本控制台里 import 的模块和界面里用的模块会打架。装完在 Python 控制台敲一句import FreeCAD能过环境就是干净的。提示虚拟机里跑 FreeCAD 要留意 OpenGL 支持。手册原文就写了“在虚拟机中安装 FreeCAD性能可能会较低某些情况下由于 OpenGL 的限制而无法使用”。真要在虚拟机里练先把 3D 加速打开否则 3D 视图会黑屏或者只剩线框。2.3 七个首选项改完后面能省一半事装完第一次启动FreeCAD 会弹开始中心页。手册建议先别急着建模去“编辑 → 首选项”把几个开关设好。这几个参数不是可有可无的装饰它们直接影响你后面出错时能不能查、崩了能不能救回来。按重要性排首选项页参数建议值影响常规语言中文若菜单出现中英混杂属正常影响界面不影响命令和脚本常规自动加载模块关闭避免启动时加载一堆用不上的工作台拖慢启动常规启动时创建文档关闭直接进自己选的工作台省一次点击常规存储 / 崩溃恢复开启自动保存间隔 510 分钟崩溃后能找回工作常规创作和许可按需选知识共享类许可证决定新文件的默认元数据输出窗口将 Python 消息重定向到报告视图勾选脚本报错时能在报告视图看到堆栈单位默认单位制MKS毫米-千克-秒手册所有示例按 MKS 写改了会错位第三行“启动时创建文档”和第四行“崩溃恢复”是配套的。手册原文说“结合上面的选项这会启动 FreeCAD 准备工作”翻得含糊实际意思是关掉开始中心、关掉自动建文档之后软件启动就是一张空白工作台你从文件菜单自己新建节奏更可控。崩溃恢复间隔别设太短五分钟一次在大装配体上会明显卡顿也别太长十分钟是能接受的上限。第六行是排查问题的黑匣子。FreeCAD 的 Python 脚本出错时默认只在控制台闪一行红字勾上重定向之后完整的 traceback 会进报告视图哪个文件哪一行一目了然。没有这个开关你写十行脚本报个 NameError得自己一行行猜。第七行单位制是新手最容易忽略、后果最直接的。手册里所有尺寸——砖块的长宽高、网格偏差、切片层高——全部按毫米给。如果你把默认单位改成厘米或英寸界面上输入的数字含义就变了导出的 STL 到了切片器里尺寸能差十倍。改单位这事儿等你能分清每个工作台各自的单位设置再动。3. 3D 视图与工作台导航手势和 CSG草图约束两条路线的选型3.1 3D 视图导航三键鼠标是硬门槛手册 1.2.1 节只有半页纸讲“在 3D 视图中导航”机翻之后更看不懂但这一节恰恰是新手第一道坎。FreeCAD 默认的导航方式对鼠标有要求左键选对象中键按住平移滚轮缩放中键加左键或者右键按住旋转视图。触控板用户会很痛苦我一般直接建议插个三键鼠标这不是玄学是效率问题。视图操作还有几个手册没细说但天天要用的数字小键盘的 1 到 6 对应前后左右上下六个正交视角按 0 回到等轴测选中对象后按空格键切换显示/隐藏视图菜单里有“视图立方”右上角那个小方块点一下能快速切面。零件装到十几个之后靠鼠标绕圈找方向是不够的正交视图加视图立方才是正路。还有一条边界视图里看到的和对象真实的几何是两回事。FreeCAD 的显示用的是细分渲染你放大到极限时会看到曲面有棱角那是显示精度不够不代表模型坏了。真正判断精度要看属性里的几何数据或者导出网格时设的偏差参数——这个在第 4 章会展开。3.2 工作台不是菜单栏Part、Part Design、Draft、BIM、FEM 的边界手册 1.2.2.3“所有工作台一目了然”这节标题很诱人内容其实是一张几百个图标的大表机翻之后基本没法读。我按实际使用频率把主要工作台重新归一下类工作台干什么什么时候用不适用场景Part基本体素和布尔运算CSG快速搭积木、布尔交并差需要改尺寸还保持特征关联时Part Design草图 特征树拉伸、旋转、倒角单个零件的参数化建模多实体装配混在一个文档里Sketcher二维草图和约束所有 Part Design 特征的底稿直接画三维曲线Draft二维绘图和基础三维操作建筑平面、辅助线、阵列精细机械零件BIM建筑信息模型墙体、楼板、门窗小零件FEM有限元分析受力、热分析前处理快速验证形状TechDraw出二维工程图需要标注尺寸的图纸只要 3D 打印时Path生成 G 代码机床加工CNC 铣削路径3D 打印切片这张表的关键不是记名字是理解工作台的切换语义切换工作台只换工具栏不换文档内容。同一个文档里可以先用 Part 建个方块再切到 Part Design 加特征对象都在同一棵树上。新手常见误解是以为换工作台等于换文件于是建了三个文档分别装三个零件最后装配时对不上。手册里 1.2.4 节讲“设置基本首选项”时提到“跳过此步骤直接在您选择的工作台中开始 FreeCAD 会话”这句话的实际含义就是上面说的工作台是会话级的视图配置不是文件级的东西。3.3 CSG 与草图约束两条路线的手感差异和选型判据手册 1.1 节标题叫“传统造型CSG 方式”1.2.3.3 节叫“产品设计建模”这两节其实对应 FreeCAD 里两条完全不同的建模哲学原文没把对比讲透只给了各自的步骤。CSGConstructive Solid Geometry路线走的是体素布尔Part 工作台里放一个立方体、一个圆柱布尔相减挖个孔再布尔相加拼个凸台。优点是上手快五分钟能出个像样的东西缺点是无法回头改——你把圆柱的位置改了减出来的孔位置跟着变这没问题但如果你想把“先减后加”的顺序调过来特征树不支持重排只能删了重做。草图约束路线走的是特征历史Part Design 里先画草图标上长度、角度、相切、对称这些约束再拉伸成实体后续的倒角、挖槽都挂在这条历史链上。优点是改一个尺寸整条链自动重算缺点是最前面那张草图如果过约束或者欠约束后面所有特征都会跟着炸。手册里讲“选择对象”“操作 FreeCAD 对象”的章节默认你已经在用这条路但没强调约束的质量。选型判据我一般这么给这个东西只做一次、形状靠感觉调的走 CSG这个东西要做多个变体、尺寸要反复改、以后可能给别人改的走草图约束。3D 打印件绝大多数属于后者因为打完发现孔小了 0.2 毫米要重来是常态能改参数比什么都重要。4. 从模型到实物转网格、Slic3rCura 导出与 G 代码检查4.1 转网格偏差参数是画质和文件大小的扳手手册 1.2.4.2 节“将对象转换为网格”只有一段话但它决定了你导出的 STL 到底是圆滑的还是带棱角的。FreeCAD 里的实体是解析几何真正的圆柱面切片器只认三角网格转换过程就是拿一堆三角形去逼近曲面逼近的精度由两个参数控制。图形界面上的路径是选中对象 → 文件 → 导出 → 选 STL弹窗里能设偏差。脚本方式的控制更细import FreeCAD as App import Mesh import MeshPart doc App.getDocument(Unnamed) # 换成你的文档名 obj doc.getObject(Box) # 换成你的对象内部名称 # 把解析几何实体转成三角网格 mesh MeshPart.meshFromShape( Shapeobj.Shape, LinearDeflection0.1, # 线性偏差单位 mm常用 0.05 ~ 0.5 AngularDeflection0.5, # 角度偏差单位弧度控制小曲面的细分密度 RelativeFalse # False 表示偏差按绝对值算不随尺寸缩放 ) Mesh.export([mesh], /tmp/part.stl)LinearDeflection是最常调的。给 0.1 意思是网格表面和真实曲面之间的最大距离不超过 0.1 毫米。数值越小曲面越圆三角形越多文件越大切片越慢。一个直径 20 毫米的圆柱偏差 0.1 大概能出几十个侧面打印出来肉眼基本看不出棱偏差给到 1.0侧面就剩十几个面打出来是个多边形柱。我一般按打印精度定FDM 打印机层高 0.2 的时候偏差给 0.05 到 0.1 就够再细是浪费因为喷头本身分辨率到不了。AngularDeflection管的是曲率变化剧烈的地方比如倒角过渡、螺纹根部。它和线性偏差是“或”的关系哪个先触发就用哪个细分。给 0.5 弧度是个稳妥值调到 0.1 会让小圆角生成大量三角形。RelativeFalse这一项容易被忽略。设成 True 时偏差按包围盒尺寸的比例算大零件会自动放粗、小零件会自动收紧听起来智能实际上会让同一批零件的网格密度不一致切片参数不好统一。批量出件我固定用 False。代码跑完记得确认文件生成了Mesh.export失败时不一定抛异常路径没写对就静默什么都没发生。4.2 Slic3r 与 Cura 两条导出链手册 1.3 节整章讲“为 3D 打印准备模型”分 1.3.5.1 到 1.3.5.5 五小节分别对应直接导出 STL、用 Slic3r、用 Cura 插件、导出到切片器、生成 G 代码。这五节在原文里的顺序是乱的实际只有两条链第一条是导出 STL 再用外部切片器。FreeCAD 里文件 → 导出 → STL然后打开 Slic3r把 STL 拖进去。Slic3r 里要确认三件事打印机配置文件选对喷嘴直径、成型尺寸、层高设 0.2 左右、填充率 15% 到 20% 对结构件够用受力件往 40% 以上走。这条链的好处是切片器独立参数可以存成配置反复用。第二条是在 FreeCAD 内部调 Cura 引擎。手册 1.3.5.4 提到“使用 Cura 插件”前提是你得先在附加内容管理器里装上 Cura 工作台。装完之后 Path 或者 Cura 工作台里能直接切片省了导出再导入。缺点是插件版本跟 FreeCAD 版本绑得紧升级 FreeCAD 之后插件经常要重装而且插件里的参数面板不如独立 Cura 全。我一般给新手的建议是先用第一条链把 STL 导出这一步走通插件等熟悉了再说。两条链有一个共同的坑单位。STL 文件格式本身不存单位切片器默认按毫米读。FreeCAD 默认也是毫米所以正常情况是对得上的。但如果你在首选项里改过单位制或者从别处导入了一个按英寸建的模型导出后到切片器里尺寸会差 25.4 倍——要么小得看不见要么大得超出成型尺寸。切片器里看到模型尺寸不对第一反应应该是回去查 FreeCAD 里对象的实际尺寸而不是在切片器里缩放。4.3 生成 G 代码前后要看的三个位置手册 1.3.10 节“生成 G 代码”只有标题和几行机翻实际检查点就三个开头看温度和归零。G 代码前几十行里应该有M104/M109设喷嘴温度、M140/M190设热床温度、G28归零。温度跟你耗材对不上PLA 打到 240 度或者没有归零指令说明切片器的打印机配置选错了。中间看层高和回抽。搜一下G1 Z的取值序列相邻两个 Z 的差值就是实际层高。如果切片器里设 0.2 而 G 代码里是 0.3说明配置没生效。回抽参数看G1 E的负值段回抽距离太大容易堵太小会拉丝。结尾看关机和抬升。M104 S0、M140 S0关加热G91切相对坐标后抬 Z 再G90回绝对坐标这套收尾动作缺了的话打印完喷嘴会烫在模型上留个坑。这三处检查花不了一分钟但能挡掉大半“打出来一坨”的事故。5. 避坑排查机翻手册翻不过去的五个坎5.1 安装与启动阶段的三个坑现象装完双击图标闪一下就没了或者 3D 视图一片黑。原因多半是显卡驱动或 OpenGL 版本不够虚拟机里尤其常见。手册原文提了一句“由于 OpenGL 的限制而无法使用”但没给解法。解决顺序是先确认不是虚拟机是的话开 3D 加速再更新显卡驱动还不行就在启动参数里加软件渲染模式。真跑不动图形界面命令行模式的 FreeCAD 照样能跑脚本建模只是看不到视图。现象界面一半中文一半英文菜单项翻得莫名其妙。原因是翻译覆盖率FreeCAD 只有五六种语言是接近完整的中文的部分工作台和新增命令还没翻。这不是安装坏了别重装。解决办法是把语言切回英文对照手册读或者忍着中英混排——命令名和参数名在脚本里永远是英文早点习惯英文界面反而少一层转换。现象Python 控制台里敲import FreeCAD报 ModuleNotFoundError。原因是用错了 Python 解释器——你在系统终端里跑的是系统 Python不是 FreeCAD 自带的那个。解决方法是所有脚本都在 FreeCAD 内部的 Python 控制台里执行或者用 FreeCAD 安装目录下的 python 可执行文件。手册里“不需要设置 PYTHONPATH”那句话就是在说这个别反着来。5.2 建模与导出阶段的三个坑现象改了一个尺寸整个模型变形或者报错特征树上出现红色感叹号。原因是草图过约束或者引用了不稳定的外部几何。新手常做的是在草图里捕捉了另一个实体的边那条边一改草图就失去参照。解决办法是回到出问题的草图删掉外部引用改用尺寸约束把位置定死过约束的话Sketcher 会提示哪几个约束冲突按提示删。现象导出的 STL 在切片器里尺寸不对差 10 倍或者 25.4 倍。原因是单位。检查两处首选项里的默认单位制以及导出对话框里有没有单位选项。10 倍通常是厘米和毫米搞混25.4 倍是英寸。修法是回 FreeCAD 把单位改回毫米重新导出不要在切片器里缩放——缩放会把圆角也一起拉变形。现象脚本里改完参数模型外观没变。原因是没调recompute()。FreeCAD 的参数化依赖一条重算链你改了Length属性对象不会自动重新生成几何得显式触发。在图形界面里改属性会自动重算脚本里不会。养成习惯每次批量改完参数末尾加一句doc.recompute()然后读一下obj.Shape.Volume确认数值真的变了比看视图靠谱。6. 进阶用 Python 控制台把重复建模压成一个函数手册 1.4 节往后的 Python 脚本内容是这本机翻材料里最值钱的部分——它给了“操作对象、读取属性、写属性、创建参数对象”的完整链条只是被翻译得七零八落。把这些串起来的实际用法是这样你要做一排尺寸递变的砖块界面里复制粘贴十次是体力活脚本里就是个循环。import FreeCAD as App doc App.newDocument(bricks) # 参数集中放一处改这里就够了 lengths [180, 190, 200, 210, 220] WIDTH, HEIGHT, GAP 95.0, 55.0, 10.0 for i, L in enumerate(lengths): b doc.addObject(Part::Box, fBrick_{i}) b.Length float(L) # 属性名区分大小写 b.Width WIDTH b.Height HEIGHT b.Placement.Base.x i * (L GAP) # 沿 X 轴排开 doc.recompute() # 验证打印每个实体的体积和位置 for o in doc.Objects: print(o.Name, round(o.Shape.Volume, 2), round(o.Placement.Base.x, 2))这段代码的关键不在语法在三个地方。addObject的第一个参数Part::Box是类型标识写成PartDesign::Pad就变成拉伸特征但后者需要先有草图不能凭空建。属性赋值必须用浮点写成整数在某些版本里会静默失败float()包一层不亏。Placement.Base是位置别去改Shape形状是计算结果改了会被下次重算覆盖。验证方法是看最后那段打印五个体积应该随长度线性变化位置应该是累加的。如果体积全都一样说明Length没赋进去如果位置全在原点说明Placement那行没生效——这两个错误在机翻手册里都不会告诉你只能靠输出对比。更进一层是把这个循环包成函数参数收成列表存成.FCMacro放进宏目录以后从宏菜单一键调用。我在做系列化零件的时候就是靠这个省掉重复劳动改一个数组重新跑一遍比在界面里复制粘贴稳得多。从那以后我每次写脚本改模型都会在末尾强制加一段体积和位置的打印——不是不信任自己是被“看起来变了其实没重算”骗过太多次。希望帮到你。本文还有配套的精品资源点击获取