简介这份FreeCAD中文教程由官方文档wiki内容翻译整理而成面向零基础入门者以及希望系统梳理建模流程的3D爱好者帮助读者解决官方wiki信息庞杂、新手难以导航的问题。全篇按循序渐进的顺序组织从Windows、Linux、Mac三平台的安装与卸载讲起依次覆盖3D视图导航与3D空间概念、参数对象与属性界面的理解、传统CSG建模与2D绘图、工作台与自定义界面设置再延伸到导入导出其他文件格式、FEM有限元分析、Cura与Slic3r切片插件、Python脚本编写、BIM建模、G代码生成及2D图纸输出等进阶主题示例驱动的叙述便于边读边练。压缩包内为1个PDF文件约14.8MB单文件结构适合离线阅读与全文检索可直接按目录跳转到具体章节译文保留机器翻译痕迹关键术语建议对照官方wiki核对。目前已有10990人学习下载适合作为初次接触FreeCAD时的系统读物与日常查阅手册。1. 先弄明白一件事FreeCAD 到底是个什么东西零基础能不能学会第一次听说 FreeCAD 的人八成会先冒出一句这不就是个免费的 SolidWorks 吗这话对了一半。它确实能建三维模型也确实不要钱但它走的是另一条路——开源、跨平台代码和文档都摊在阳光下谁都能改、谁都能提意见。而「FreeCAD 中文教程」之所以值得单独拎出来讲是因为官方那份文档更像一本字典条目齐全、内容海量新手翻起来是真的会迷路。它能干的事比很多人想的杂小到一颗电子元件大到一栋房子的结构框架都能建重点是能把模型变成可以打印、可以出工程图、可以交给别人继续修改的文件。适合谁适合想学三维建模、又不打算先掏一笔授权费的学生、爱好者和小团队。这份翻译版教程做的事是把那本字典重新排成一条能顺着走的路。2. 装好再动手三个平台的安装和第一次打开的设置清单很多人卡在第一步不是因为笨是因为装完打开一看界面全是按钮不知道点哪个然后就关掉了。这一章的目标很朴素让你把软件装上、把几个关键设置调好、把界面上每一块区域是干什么的认全。做完这三件事你才有资格谈建模。先说清楚一个前提FreeCAD 在 Windows、Mac、Linux 上的运行表现几乎一模一样区别只在安装方式。所以你在教程里看到的操作步骤换台电脑基本照搬不用重新学一遍这一点对新手其实很友好。2.1 Windows、Mac、Linux三条安装路线分别怎么走Windows 是最省事的一条路。去官方下载页拿对应位数的安装包.exe双击接受那份宽松的开源许可证——这份协议没什么隐藏条款你可以放心点接受——路径保持默认就行除非你有明确的理由改。安装过程里会顺带装上一个 Python 环境你不用管它后面写脚本的时候它会自己冒出来干活。装完在开始菜单里搜一下就能找到。Mac 的路子稍微「野生」一点。下载下来是个压缩包解压后把应用图标直接拖进「应用程序」文件夹就算装完了。第一次打开如果系统拦你说这个应用不是从应用商店来的去系统设置里给它放行一次即可这是 Mac 对所有非商店应用的统一待遇不是软件有问题。Linux 最简单也最舒服。打开你发行版自带的软件管理器搜 freecad点安装完事。有些发行版还提供社区维护的软件源能拿到更新的版本。如果你想让稳定版和尝鲜版共存去下载页拿那个压缩包解压到任意目录双击里面的可执行文件就能跑两个版本互不干扰。提示如果你打算在虚拟机里装先有个心理准备——三维视图对图形性能有要求虚拟机里可能卡顿甚至因为图形接口限制而打不开视图。真要学建议装在物理机上。还有一个常被忽略的细节卸载。Windows 走控制面板的标准卸载Linux 用同一个软件管理器删掉Mac 直接把应用拖进废纸篓。没有注册表残留的玄学也没有藏起来的后台服务这也是开源软件让人放心的地方。2.2 第一次打开别急着建模先改这五项设置装完打开先别急着点新建。花五分钟把首选项过一遍能省掉后面一大堆莫名其妙的麻烦。首选项在「编辑 → 首选项」里页面不少但真正对新手有影响的就那么几个。第一项是语言。软件会自动跟随你的操作系统语言如果你系统是中文大概率开箱就是中文。想换的话在这里改改完重启生效。中文翻译已经覆盖了绝大部分界面剩下少量没翻译的词不影响使用。第二项是启动行为。默认情况下打开软件会先给你一个起始中心页面上面一堆快捷入口。如果你跟我一样嫌它多一步可以把「启动时显示起始中心」关掉同时打开「启动时创建新文档」这样每次点开就是一个空白文档直接进工作台。第三项是崩溃恢复。三维建模软件都难免崩尤其是模型复杂的时候。首选项里有个自动保存相关的设置把间隔调短一点比如十分钟崩了之后还能从恢复文件里捞回来。这是我用血泪经验换来的一条建议别嫌它烦。第四项是把 Python 的消息重定向到输出视图。这个名字听起来很技术说白了就是让软件把后台脚本的报错信息显示出来。默认它可能藏着不吭声一旦你后面开始写脚本出错时啥也看不到会非常抓狂。两个相关选项都勾上从此报错有迹可循。第五项是单位。默认是毫米-千克-秒这一套做机械件和小零件就用它别改。后面教程里的例子都是按这套单位写的你半路换成英寸尺寸全对不上排查半天才发现是单位在作妖。顺手还可以看一眼「创作和许可」那一页那里设的是新文件的默认作者信息和许可证。如果你做的东西打算分享出去选一个宽松的开放许可证会让别人用起来更省心。2.3 界面扫盲3D 视图、导航和工作台到底各管什么第一次看到界面密密麻麻的工具栏会让人本能地想关掉几个。先别关认清楚它们分别管什么比关掉有用。中间最大那块是 3D 视图你的模型就长在这里。视图右上角一般有个小方块一样的东西叫导航立方体点它的面、棱、角视角就会转到对应的正视图、侧视图、俯视图或者等轴测图。鼠标操作也有讲究按住中键拖是平移滚轮是缩放按住中键加左键或者右键拖是旋转。刚开始会手忙脚乱练十次就顺了。左边通常是模型树显示这个文档里有哪些对象、谁是谁的子对象、谁依赖谁。这个面板以后会非常重要——模型出问题的时候第一个要看的就是它。模型树下面是属性编辑器选中一个对象它的所有参数都在这里列着改一个数字模型立刻跟着变这就是参数化最直观的样子。上面一排是工作台选择器。工作台这个概念可以理解成「工具箱切换」画草图有草图工作台做实体布尔运算有零件工作台出工程图有制图工作台做建筑设计有建筑工作台。它们不是不同的软件是同一套内核外面挂的不同工具组。新手最容易犯的错就是一直在默认工作台里找按钮找不到就以为软件没这功能。注意找不到某个按钮时先看一眼左上角当前是哪个工作台九成的情况是工具在别的工具箱里。底部或者侧边还有一块输出/报告视图平时它安安静静出错的时候它会说话。养成习惯模型行为异常先看这里。3. 建立参数化思维一块砖的三个数字藏着整个建模逻辑界面认全了接下来要建立的是思维方式。FreeCAD 跟画图软件最大的区别不在工具多而在它认为「模型是一堆参数算出来的结果」。这个观念要是没转过来你会一直用画图的方式去用它然后觉得处处别扭。这一章不打草稿先把三个概念掰开揉碎参数化到底参数化了什么、两种建模路线该先学哪个、一个工程文件内部到底长什么样。3.1 一块砖的三个数字参数化到底把什么变成了可调的拿一块最普通的砖举例。它有长、宽、高三个数字这三个数字就是它的参数。在传统建模里你把这三个数字「烤」进模型模型就定型了想改只能重画。在 FreeCAD 里不是这样。这三个数字作为对象的属性一直活着你随时可以回头把高度从 50 改成 80模型自己会重新算一遍。更妙的是参数不一定非得是数字。你可以再建一个对象把「这块砖」本身当成它的输入比如让一摞砖沿着某个方向排成一根柱子——砖的数量、间距也是参数改一下柱子跟着变。所以有个说法我特别喜欢参数化对象就像一段小程序输入是几个数字或者几个别的对象输出是几何形状。你改输入它就重新跑一遍。理解了这句话你就理解了 FreeCAD 一半的设计哲学。这也解释了为什么它不适合「随手涂鸦」。它是给那些需要反复修改的东西准备的产品要迭代十版、建筑要改层高、零件要适配不同尺寸的螺丝孔。如果你的模型这辈子只做一次、再也不改那用什么都行但真到了要改的时候参数化能救你的命。3.2 传统 CSG 和草图约束新手先学哪一个FreeCAD 里做实体有两条主流的路线。名字听起来吓人其实都很朴素。第一条叫 CSG直译是「构造实体几何」你可以理解成搭积木加切豆腐。系统给你一堆基础形状立方体、圆柱、球、圆锥。你先摆几个上去然后用布尔运算把它们加在一起、减掉、或者取交集。想做个带孔的板子拿一个方块再造一个圆柱当钻头从方块里减掉孔就有了。第二条叫草图加约束。先在平面上画一个二维轮廓画的时候给它加「约束」——比如这两条线必须平行、这个角必须是直角、这条边的长度锁定在 30 毫米。约束加够了轮廓就被完全定死不会因为拖动而变形。然后把轮廓拉伸成三维实体或者绕某根轴旋转成回转体。两条路各有各的用处但入门顺序我建议是先 CSG、后草图。原因很实在CSG 的思维模型跟搭积木完全一致零基础也能在五分钟内做出第一个实体立刻有成就感而草图约束有一套自己的逻辑欠约束、过约束、约束冲突新手上手就容易卡在报错上很容易打击信心。等你用 CSG 把布尔运算玩熟了再进草图工作台。那时候你已经知道最终要做出什么形状学约束就是学「怎么精确地描述它」动力完全不一样。3.3 文档、对象、属性把工程文件看成三层抽屉打开一个 FreeCAD 文件表面上是一堆模型底层其实是三层结构理解它能让你后面少走很多弯路。最外面是文档。一个文件就是一个文档文档是容器负责装东西也负责存盘。你可以把它想象成一个大抽屉。抽屉里放的是对象。立方体是一个对象圆柱是一个对象布尔运算的结果也是一个对象。对象有名字也有一棵父子关系树——被用来做减法的那个圆柱就是布尔对象的子节点。删掉父对象子对象的行为要看你删的是哪一头这也是模型树要经常看的原因。对象身上挂的是属性。属性分两大类一类管几何比如长度、半径、位置一类管外观比如颜色、透明度、线条粗细、是否可见。前者影响模型长什么样后者只影响它看起来什么样。新手常把这两类搞混改了半天颜色以为改了尺寸。还有一件事必须提重算。参数改了之后模型不会自动更新到最终状态你需要手动触发一次重算让系统把整条依赖链从头算一遍。这个动作在界面里是个刷新按钮在脚本里是一句 recompute。忘记重算你看到的永远是旧结果然后你会怀疑自己是不是改错了地方。4. 跑通第一个例子从草图到能打印的实体板子前面三章都是铺垫。这一章开始动手做一块带安装孔的板子。它的尺寸不大结构也简单但把「创建对象 → 改参数 → 布尔运算 → 改参数验证 → 导出」这条完整链路走了一遍。走完这一遍你就不是在看教程而是在用工具了。我会给两种做法先用界面点出来再用一段脚本复刻同样的结果。前者让你看见过程后者让你看见本质——这两件事都是新手必须经历的。4.1 第一个例子做一块带孔的安装板打开软件新建一个文档把工作台切到零件工作台。接下来按步骤走每一步都别跳。第一步创建一个立方体。在工具栏里找到立方体按钮点一下3D 视图里出现一个正方体左侧模型树里多了一个对象。选中它在下方的属性编辑器里找到长度、宽度、高度三个属性分别改成 60、40、10。板子的主体就有了。第二步创建一个圆柱。同样在工具栏里找圆柱按钮点一下。把半径改成 8高度改成 20让它比板子厚这样切出来的才是通孔而不是盲孔。第三步把圆柱挪到板子上。找到圆柱的位置属性把它的坐标设为 X 30、Y 20、Z -5。Z 设成负数是故意的圆柱的高度只有 20板子厚 10如果底部对齐圆柱只能穿透一半上面留一层薄皮孔就不通。往下挪 5 毫米它就从板子底下穿到上面干净利落地切穿。第四步做布尔切除。选中方块按住 Ctrl 再选中圆柱然后在工具栏里点「切除」。模型树上会多一个结果对象视图里板子中间出现一个圆孔。点一下结果对象的显示开关可以看到它的内部——这是一个实心带孔的板子不是两个零件叠在一起。第五步验证参数化。选中方块的宽度属性从 40 改成 60按一下重算。板子变宽了但孔还在原来的位置现在偏左了。这恰好证明了一件事孔的位置是圆柱的独立参数它不会跟着板子自动挪。想让孔始终居中得用表达式把圆柱的 X 坐标绑到板子宽度的一半上这是下一步要学的技巧。提示如果布尔运算报错说结果为空或者形状无效八成是两个实体没有真正相交。检查一下圆柱的位置和高度确认它确实穿过了板子。这块板子虽然简陋但你已经完整走了一遍建对象、改参数、组合、验证。接下来所有的复杂模型本质上都是这一步的重复和叠加。4.2 用 Python 复刻同一块板子十几行代码看懂的建模逻辑FreeCAD 内置了 Python 控制台界面上大部分操作都能用代码表达。这不是给程序员准备的附加功能而是这个软件的核心设计——很多人不知道它的整个界面其实就架在这套脚本接口之上。在菜单里打开 Python 控制台把下面这段敲进去一行一行来import FreeCAD as App import Part # 新建一个文档相当于文件 - 新建 doc App.newDocument(MyFirstPart) # 造一个方块长 60、宽 40、高 10 box doc.addObject(Part::Box, Brick) box.Length 60 box.Width 40 box.Height 10 # 造一个圆柱当钻头半径 8、高 20 hole doc.addObject(Part::Cylinder, Hole) hole.Radius 8 hole.Height 20 # 把圆柱往下挪 5 毫米保证能穿透 10 毫米厚的板子 hole.Placement.Base App.Vector(30, 20, -5) # 布尔切除方块减去圆柱 cut doc.addObject(Part::Cut, Plate) cut.Base box cut.Tool hole # 重算让模型真正生成出来 doc.recompute()跑完之后切回三维视图你会看到跟上一节点出来的一模一样的板子。逐行解释一下前两行是导入模块App 管文档和对象Part 管几何形状newDocument 建容器addObject 往里塞对象第一个参数是对象类型第二个是给它起的名字这个名字你后面要用来找它别乱起Length、Width、Height 就是属性赋值跟你在界面上改数字是同一件事Placement.Base 设的是位置Vector 三个数分别是 X、Y、Z最后两行建立布尔关系然后重算。现在试试这个在控制台里敲box.Width 80再敲doc.recompute()板子立刻变宽。同一件事界面上要点三下代码里两行。这就是为什么老手喜欢用脚本——不是炫技是改起来快。再教你一个很实用的小技巧用它来认识对象obj App.ActiveDocument.getObject(Plate) for prop in obj.PropertiesList: print(prop, , obj.getPropertyByName(prop))这段会把这个对象身上所有属性的名字和当前值全打印出来。新手对着一个陌生对象不知道能改什么跑一遍这段就心里有数了。属性名就是你在界面上看到的那些一一对应。注意Python 对大小写敏感Length 写成 length 会直接报错。遇到报错别慌先看输出视图里的最后一行通常那句话就写清楚了哪个名字不对。4.3 导出网格并丢进切片软件看它到底能不能打印模建好了下一步是把它变成打印机认识的文件。三维软件里的实体是数学描述打印机要的是三角面片拼成的网格中间需要一次转换。在界面上的做法是选中最终的板子对象在零件工作台或者网格工作台里找到「创建网格」相关的功能弹出的对话框里会让你设偏差和角度这两个参数。偏差越小曲面越细腻文件也越大反过来偏差大圆孔会变成多边形。做 3D 打印的零件把偏差调到 0.1 毫米左右通常够用先别追求极限精度。用代码也一样两行搞定import Mesh Mesh.export([App.ActiveDocument.Plate], /tmp/plate.stl)第一行导入网格模块第二行把指定的对象导出成 STL路径自己改成本机存在的目录。导出完成后拿切片软件打开这个文件如果看到一块带孔的板子躺在打印平台上恭喜你这条链走通了。切片软件里记得看一眼层高和填充率第一次试打可以设 0.2 毫米层高、20% 填充速度别拉满。板子平放着打孔是竖直方向的不需要支撑。打出来之后拿在手里你会发现前面那些抽象的概念突然变得很实在。提示如果切片软件打开是空的先回 FreeCAD 确认导出的对象确实被选中了再确认导出的是网格而不是原始实体。这个坑很常见。5. 新手上路避坑五个最容易翻车的现场和补救办法前面四章走的是顺风顺水的路线但真实学习过程中卡住你的往往不是「不会做」而是「做了但不对还不知道错在哪」。这一章把新手最常撞的五个坑列出来每个都按「现象 → 原因 → 解决」讲清楚遇到的时候直接对照。5.1 装完点不开或者界面全是英文现象双击图标没反应或者好不容易打开菜单全是英文跟教程里对不上。原因点不开多半是图形驱动或者权限问题全英文则是因为软件没找到中文语言包或者系统语言设置没被正确识别。解决先确认你的系统位数和安装包位数一致32 位的包装在 64 位系统上能装但跑不动。Mac 上如果是权限拦截去系统设置里给这个应用放行一次。至于语言去首选项的语言页面手动选中文然后重启软件——很多人改完不重启以为没生效其实只是在等重启。5.2 草图看着是封闭的一拉伸就报错现象草图画完了线条首尾相接肉眼看着是个闭合轮廓但一执行拉伸就提示「无法确定轮廓」或者结果是个空壳。原因看上去接上了不等于真的接上了。两条线的端点坐标差 0.001 毫米视觉上完全看不出来但对几何内核来说就是两个点轮廓没闭合。另一种情况是线条自己交叉了形成了自相交。解决用草图工作台里的「验证草图」功能它会直接把有问题的点标出来。更根本的办法是别用鼠标随手画画完立刻加约束——把相邻端点约束成重合把该水平的约束成水平。约束加满了轮廓在数学上就是闭合的拉伸不会再出问题。这个习惯越早养成越好。5.3 改了个参数整个模型崩了现象本来好好的模型你把某个尺寸从 40 改成 20结果模型树上出现一堆红色标记视图里的东西消失了一半或者形状变得完全看不懂。原因参数之间有依赖关系你把父对象的尺寸改小了依赖它的子对象比如那个要切穿的孔就跑到实体外面去了布尔运算算不出结果。这不是软件坏了是几何上真的不成立。解决先撤销回到能用的状态。然后打开模型树从最底下往上一个个看找出第一个变红的对象问题通常就在它身上。养成一个习惯改参数的时候一次只改一个改完立刻重算看一眼别一口气改五个再一起看——那样出问题你根本不知道是哪个引起的。5.4 导出的 STL 是空的或者切片软件不认现象导出的时候一切正常文件也有大小但拖进切片软件里什么都没有或者切片软件直接提示文件无效。原因最常见的是导出时没选中对象导出的是一个空文档。其次是对象本身是「壳」不是「实体」比如几个面拼起来但没有封闭体积切片软件判断不出内外。还有一种是把草图或者基准面导出去了那本来就不是三维东西。解决导出前在模型树里点一下目标对象确认它被高亮选中。导出后在文件管理器里看一眼文件大小几百字节的基本就是空的。如果大小正常但切片软件不认回到软件里检查这个对象是不是「实体」——在属性里通常能看到相关信息或者用几何检查工具跑一遍它会告诉你哪里破了洞。5.5 Python 报错了却找不到原因现象在控制台里敲了几行代码回车之后什么都没发生或者只冒出一行看不懂的英文。原因Python 的错误信息默认可能没被显示出来尤其是从界面触发脚本的时候错误被吞掉了。解决回到第 2 章那个设置把 Python 消息重定向到输出视图的两个选项都勾上。然后学会看报错的最后一行那里通常写着错误类型和出问题的位置比如「某个名字不存在」八成就是你把属性名拼错了。第一次看不懂没关系把那一行原样搜一下你会发现几乎所有新手错误都有人踩过。6. 第一个例子之后接下来三个月的学习顺序该怎么排板子打出来了软件也装顺了接下来最怕的不是学不会是学乱了。东看一章西看一章一个月后回头发现什么都没串起来。我把自己走过的顺序整理成一条线你可以照着走也可以按自己的兴趣调整但大方向别反。6.1 按月拆开的一条学习线第一个月只做一件事把草图约束练到不假思索。这是整个软件里最值得投入时间的地方也是最容易劝退的地方。每天画三个二维轮廓方形的、带圆角的、带对称的画完必须让草图变成「完全约束」状态。完全约束的意思是所有自由度都被锁死了拖动任何一条线都动不了。做到这个程度你才算真正掌握了草图。阶段主攻内容判断学会的标准第 1 个月草图与约束随手画一个轮廓能全部约束住不报错第 2 个月拉伸、旋转、布尔、阵列不看教程做出一个带孔带圆角的多零件装配第 3 个月出图、脚本、导入导出能把模型导成 STL 打印也能用脚本批量改参数第二个月开始做真正的零件。从身边的东西入手一个手机支架、一个抽屉把手、一个需要三个零件配合的小盒子。这个阶段的核心是学会用「特征」的思维组织模型——先做什么、后做什么、哪个特征依赖哪个特征。顺序排得好改参数的时候一路顺顺序排得乱改一个地方全盘重来。第三个月才开始碰那些看起来高级的东西工程图、脚本、各种文件格式的互转。到这个时候你会发现它们其实不难因为它们都建立在前面两个月的基础上。反过来如果你第一个月就去研究脚本很可能卡在「不知道该让脚本干什么」——因为你还没有想做的模型。6.2 几个能省下大量时间的习惯第一个习惯是给对象起有意义的名字。默认名字是「立方体001」「立方体002」做到二十个对象的时候你在模型树里根本找不到谁是谁。建完立刻改名叫「底板」「定位孔」「加强筋」这个动作只花两秒。第二个习惯是每做完一个阶段就存一次盘并且用不同的文件名。三维软件崩起来不讲道理我吃过一次亏两个小时的工作量没了从那以后我每次做完一个关键特征都会强制存一遍盘而且会在文件名后面加个序号不再覆盖上一版。第三个习惯是遇到问题先看模型树和输出视图再去搜。这两个地方能解决掉新手八成的困惑比漫无目的地翻文档快得多。如果你手上这份中文教程还没开始看建议就按这一章的节奏来先花一天把软件装好、设置调好然后从草图那一部分慢慢读。它是按顺序写的别跳着看跳着看会漏掉很多「上一章提到过所以这里不重复」的细节。希望这份东西能帮你把第一步迈出去剩下的路走着走着就顺了。本文还有配套的精品资源点击获取