简介这份FreeCAD中文教程翻译版以PDF形式呈现面向零基础自学者、机械设计与3D打印爱好者以及希望系统梳理开源参数化建模流程的工程师。内容从软件安装与界面导航讲起逐步覆盖3D视图操作、传统CSG建模、产品设计、工作台与参数对象、自定义界面、导入导出、FEM分析、Cura与Slic3r切片准备、Python脚本、BIM建模、G代码生成及2D图纸绘制并对电子表格、属性读写等进阶主题作了展开。教程强调循序渐进与示例驱动目录按学习路径组织便于按章节查阅也可作为官方wiki的配套读本。资源包共1个PDF文件约14.8MB单文件即含完整教程适合离线阅读与打印。目前已有10990人学习说明其在中文FreeCAD入门资料中具有较高参考价值。读者可借此建立参数化建模的整体认知掌握从建模到3D打印、从脚本扩展到BIM应用的完整链路并对照目录快速定位所需知识点。1. 装 FreeCAD 之前先弄清手里这份教程对应哪一版第一次装 FreeCAD 是在一台只用来写文档的旧笔记本上照着流传的 FreeCAD 中文教程一步步点向导里的默认项全部接受装完打开却发现教程写的「编辑 → 首选项」在菜单里对不上位置工作台下拉框里也找不到截图里那一项。折腾半天才想明白这份手册是为 0.16 稳定版写的而我在安装向导里顺手勾了开发版工程目录又放在带中文的路径下第一次导出 STL 就翻车。软件其实装得挺快栽的全是版本对不上、路径带中文、首选项没配这几件小事。这套环境 Windows、Linux、Mac 都能落地适合刚拿到这份中文教程准备照着敲例子的人也适合把 FreeCAD 当 3D 打印前处理工具来用的老手。2. 版本与平台对照0.16 中文手册跑在新系统上要注意什么2.1 手册的版本坐标与三平台的安装差异这份手册写明的目标版本是 FreeCAD 0.16 稳定版。官方发布页上现在的版本号已经比 0.16 往前翻了好几轮主界面骨架没大变——顶部菜单、工具栏、左侧树视图和属性视图、下方 Python 控制台、中间 3D 视图——但默认工作台、菜单项归类、参数面板的入口确实动过。照着书敲的时候如果某一项菜单找不到先去看工作台下拉框FreeCAD 把大量功能按工作台拆开了产品设计、传统 2D 绘图、BIM、FEM、网格、渲染这些都在不同工作台下。三个平台的安装机制差别不小搞错来源最容易出现「教程里是这么装的我这里没这个东西」。Windows 和 Mac 上社区提供预编译好的安装包下载下来双击或拖拽就能用Linux 上源码先交给各发行版的维护者由他们打包所以通常直接从软件管理器装。这意味着 Linux 用户装的包可能比官方发布页滞后也可能因为发行版策略打了补丁遇到行为差异先确认包来源别急着怀疑手册写错。版本选择上有两条路稳定版和开发版预发布版。稳定版是官方发布页和发行版软件管理器里给的那份开发版几乎每天都有新功能和修复通常以压缩包形式提供解压即用不写注册表也不往系统目录塞东西。我一般让新手先装稳定版把书上的例子跑完等确定要长期用了再并排放一个开发版试新功能两者可以共存互不干扰。平台安装来源形态卸载方式Windows官方发布页预编译包.exe 安装向导控制面板删除软件Linux发行版软件管理器 / 社区 PPA系统包同一个软件管理器删除Mac官方发布页预编译包.zip 内 .app从 Applications 拖到废纸篓全平台开发版官方发布页预发布区.zip 或 .7z 免安装直接删目录这张表建议先存下来后面每一步都能对上号。注意开发版是免安装的删掉解压目录就算卸载干净不会留残留这也是我愿意在主力机上同时放两个版本的原因。2.2 显卡、虚拟机与系统底线FreeCAD 的 3D 视图依赖 OpenGL。在物理机上装基本不会卡在这一步真正容易出问题的是虚拟机。手册里明确提了一句在虚拟机中安装 FreeCAD性能可能偏低某些情况下会因为 OpenGL 的限制直接无法使用。这不是危言耸听我见过在只开了基础显示驱动的虚拟机里主界面能起来3D 视图一片空白转一下模型就卡住。判断办法很直接装完打开新建文档随手拉一个立方体用鼠标中键按住拖动旋转视角能顺畅转起来就说明图形链路正常。如果 3D 视图全黑或者旋转有明显拖影先确认虚拟机有没有开启 3D 加速再考虑换到物理机。Windows 侧从 Windows 7 起的版本都在支持范围内安装包分 32 位和 64 位下载时对号入座装错位数会在启动瞬间报错退出。内存和磁盘不用太焦虑这套软件不是吃资源的类型真正占地方的是你建的模型和导出的网格。我给自己的习惯是单独划一个工作盘放工程文件别放在系统盘的用户目录下——原因在第五章会细说简单讲就是路径里的中文和空格在老版本上容易出玄学问题。2.3 语言、单位与许可证三个装完就该定的默认值语言在首次启动后就能改。FreeCAD 会自动选择操作系统的语言手册提到它几乎完全翻译成了 5 到 6 种语言其他语言目前只做了部分翻译。中文界面基本够用但有个副作用教程里的截图是英文界面术语对不上。我的做法是第一次照书走的时候先用英文界面把菜单项和术语认全等熟悉了再切回中文两边都能对上。单位制是比语言更容易埋雷的一项。手册的示例默认留在 MKS米、千克、秒制下跟着书做就别改。如果之前装过别的 CAD 顺手设了毫米或者英寸导入一个外部模型时很容易出现尺寸差 1000 倍的情况看着像模型炸了其实是单位换算。首选项里的单位页签改完要重启一次才彻底生效。许可证这块知道就行不用操作。FreeCAD 本身走 LGPL宽松到可以商用、可以再分发唯一禁止的是声称软件是你写的你用 FreeCAD 生成的数据完全属于你即便哪天不装 FreeCAD 了也能拿回来。手册内容本身走 Creative Commons 4.0可以自由使用、复制和修改。首选项里有一项「创作和许可」是给新建文件设默认许可信息的团队协作时建议一开始就设成偏 copyleft 的许可省得后期一个个补。3. Windows 安装从 .exe 向导到首选项七项3.1 安装包的选择与安装向导逐屏说明先下载对应位数的安装包文件名后缀是 .exe。双击之后进入向导第一屏是 LGPL 许可协议接受即可这份协议没有藏条款是少数可以放心直接点接受的许可页。下一屏是安装路径默认路径通常能用唯一要避免的是路径里带中文和空格我一般改成C:\FreeCAD这种短路径后面排查问题时省很多事。安装过程中有一屏会提到附加组件向导会把 Python 解释器一并装进去这是 FreeCAD 能跑脚本、能用宏、能做参数化建模的基础。手册专门说了一句不需要设置 PYTHONPATH 环境变量除非你要做一些高级的安装。很多人习惯性去配环境变量反而把自带的 Python 环境搞乱得不偿失。装完先确认入口在不在别急着打开# 装完先确认可执行文件存在路径里的目录名以你安装时选的位置为准 $exe C:\FreeCAD\bin\FreeCAD.exe Test-Path $exeTest-Path返回 True 说明安装器把文件铺到位了返回 False 大概率是安装时改了路径但记错了目录名。这一步看着多余实际上能挡掉「装完开始菜单里搜不到」的一大半疑问——搜不到往往是快捷方式没建程序本身是好的。3.2 首选项里必须过一遍的七处设置首次打开 FreeCAD先去「编辑 → 首选项」把下面七项过一遍。这一步不做后面照书敲例子会遇到一堆「怎么和书上不一样」。第一项是语言前面说过按需切换。第二项是自动加载模块正常情况下 FreeCAD 启动会先显示开始中心页面如果你每次都想直奔某个工作台可以在这里把开始中心关掉。第三项是启动时创建文档和上一项配合使用勾上以后启动直接进一个空白文档跳过欢迎页适合已经明确要开工的人。第四项是存储选项这项最重要。手册的原话是与任何复杂的应用程序一样FreeCAD 可能会不时崩溃。这里能配置自动保存间隔和崩溃恢复选项我一般把自动保存设到 5 到 10 分钟宁可多写几次盘也不愿意重画一遍。第五项是创作和许可给新文件设默认的许可信息。第六项是两个勾选框把 Python 消息重定向到输出视图同时把内部错误也输出到报告视图。手册特意强调这两个选项「总是很好标记」原因很实在跑 Python 脚本出问题时报错信息默认可能一闪而过勾上之后你能在报告视图里看到完整堆栈这是排查脚本问题的黑匣子。第七项是单位跟着手册示例走就留在 MKS。改完首选项配置会写进用户目录。动配置之前先备份一份出问题直接回滚# 首选项和界面布局都存在这个目录改坏了用备份盖回去 $cfg Join-Path $env:APPDATA FreeCAD Copy-Item $cfg -Destination $cfg-bak -Recurse -ForceJoin-Path拼出当前用户的配置目录-Recurse保证子目录一起复制。这是我在动任何界面布局、自定义工具栏之前都会做的一步后悔药先备好改崩了三十秒还原。3.3 稳定版和开发版并存.7z 便携包放哪开发版以 .zip 或 .7z 压缩包形式提供不需要安装解压后双击里面的 FreeCAD.exe 就能启动。这个形态最大的好处是可以和稳定版同时存在稳定版走安装器开发版放在一个独立目录两者共用同一份用户配置目录但程序文件互不覆盖。放置位置有讲究。别解压到桌面也别解压到下载目录更别解压到带中文的路径下。我固定放在D:\FreeCAD-dev\这种纯英文短路径解压工具用 7-Zip 完整解压不要用系统自带解压直接双击压缩包里的 exe——那样程序依赖的库文件没被真正展开启动时会缺 DLL。启动开发版时建议加一个快捷方式参数留空即可。第一次运行会提示是否沿用现有用户配置选沿用这样首选项、工作台布局都还在如果某个新版本把配置写坏了删掉开发版目录重解压再用 3.2 节的备份还原两步就回到干净状态。4. Linux 与 Mac 安装软件管理器、PPA 与拖拽放行4.1 Linux软件管理器一键装和 PPA 两条路在大多数现代 Linux 发行版上装 FreeCAD 就是打开软件管理器搜索 freecad点安装。手册描述的就是这个流程包括 Ubuntu、Fedora、openSUSE、Debian、Mint、Elementary 这些发行版各家用的软件管理器界面不一样路径是同一个。装完记得给它评个分打包和做安装器是体力活这是手册里少见的带人情味的一句。第二条路是社区维护的 PPA里面同时放稳定版和每日构建。它适合两种情况发行版仓库里的包太旧或者你想跟最新的修复。命令是标准的三板斧源名以社区发布页给出的为准别照抄占位符# 源名去社区发布页确认占位符照抄一定失败 sudo add-apt-repository ppa:社区发布的源名-stable sudo apt-get update # 不刷新索引装的还是发行版仓库里的旧包 sudo apt-get install freecadadd-apt-repository把源写进系统配置apt-get update刷新索引这一步最容易被跳过跳过之后install装到的仍是旧版本然后你会以为是 PPA 没生效。装完确认一下入口和版本which freecad # 确认可执行文件入口在哪 freecad --version # 打印版本报错或没输出说明入口指向的不是刚装的包如果which指向/usr/bin/freecad说明走的是发行版仓库那份PPA 装的路径通常在/usr/bin下同名覆盖出现两份时用apt-cache policy freecad看优先级。因为 FreeCAD 是开源软件理论上你也可以自己编译但除非要做二次开发我不建议新手走这条路依赖链太长编译半小时起步。4.2 Maczip 解压、拖进 Applications 和权限拦截Mac 上的流程最短下载对应版本的压缩包打开下载文件夹展开 zip把里面的 FreeCAD.app 拖进 Applications 文件夹就算装完了。手册也提醒了一句现实情况——社区里用 Mac 的人相对少可用的软件包通常比其他平台落后几个版本。看到版本号比 Windows 那边旧不是装错了。第一次启动很可能被系统拦住理由是「不是来自 App Store 的应用程序」的权限限制。处理方式是在系统设置里放行允许这个来源的应用运行。手册对这一段的措辞很克制——「希望你不想要这样做但无论如何知道这一点是件好事」——大意是提醒你清楚自己在放开什么权限。命令行放行等价于点「仍要打开」但知道自己敲的是什么# 去掉应用上的隔离标记本机自己放行来源不明的包别这么干 sudo xattr -dr com.apple.quarantine /Applications/FreeCAD.app-d是删除扩展属性-r递归处理 .app 内部所有文件com.apple.quarantine就是那个隔离标记。这条命令只解决「打不开」不解决「打开就崩」崩溃要看控制台日志多半是依赖或显卡驱动的事。4.3 卸载三个平台各自的干净做法卸载这件事手册写得很简短但实际操作里残留配置才是坑。Windows 上走控制面板的「删除软件」选 FreeCAD 卸载Linux 上用装它时的同一个软件管理器删除Mac 上直接把 Applications 里的应用拖到废纸篓。麻烦在配置目录。三个平台重装时都会读回旧的用户配置如果旧配置是坏的重装完问题照旧会让你误以为「重装没用」。Windows 的配置在%APPDATA%\FreeCADLinux 在用户目录下的.FreeCADMac 在用户库目录下的Application Support/FreeCAD。真想干净重来先卸程序再手工删配置目录最后重装。开发版则不用卸载删目录即可这也是我愿意拿它试新功能的原因——试坏了删掉零成本。5. 安装与首次启动排查五个真实翻车点5.1 安装阶段装不上、装完打不开的三条现象一开发版双击 FreeCAD.exe 毫无反应或者弹窗提示缺少某个 DLL。原因基本是解压不完整。用系统自带的压缩工具直接双击压缩包里的 exe程序是从临时目录跑的依赖库根本没落到磁盘上另一种情况是解压到了带中文或空格的路径老版本对非 ASCII 路径处理不干净。解决方式是换 7-Zip 这类工具完整解压到一个纯英文短路径比如D:\FreeCAD-dev\再双击目录里的 exe。我之前图省事在桌面解压卡了半小时才反应过来桌面路径里有中文用户名。现象二装完在开始菜单搜不到 FreeCAD。原因通常是安装时改了路径安装器没在开始菜单建快捷方式程序本身是完好的。先用 3.1 节那条Test-Path确认 exe 在不在在的话右键发送到桌面快捷方式即可。如果Test-Path也返回 False那才是真的没装上重新跑一遍安装器注意向导里路径那一屏别手滑。现象三Mac 上提示应用已损坏或者来自身份不明的开发者点「打开」也没用。原因是系统对非 App Store 来源应用的权限限制。先试右键点应用图标选「打开」系统会多给一个确认入口还不行就用 4.2 节那条xattr命令去掉隔离标记。注意这条命令只解决「不让运行」如果放行后一启动就退出那是程序本身的问题去控制台看日志别在这里反复折腾权限。5.2 启动与配置阶段界面和教程对不上的两条现象四手册里写的菜单项、工具栏按钮在自己的界面上找不到。原因有两层。第一层是工作台不对——FreeCAD 把功能按工作台拆分产品设计建模、传统 2D 绘图、BIM、FEM、网格、渲染这些工具集默认不全显示得先在下拉框里切到对应工作台。第二层是版本差异手册对应 0.16新版把部分菜单项合并或挪了位置。解决办法是先确认工作台再看首选项里的界面自定义把常用工作台设为默认可减少来回切换。别急着怀疑手册过时大部分「找不到」都是工作台没切。现象五跑 Python 脚本报错但界面上什么提示都没有。原因是首选项里那两个重定向选项没勾报错信息输出到了你没在看的地方甚至直接丢掉。回到「编辑 → 首选项」把 Python 消息重定向到输出视图、内部错误输出到报告视图这两项勾上再重跑脚本堆栈就老老实实躺在报告视图里了。这条我踩过不止一次第一次遇到时以为是脚本写错改了半天语法其实是错误信息压根没显示出来。这个勾选就是 FreeCAD 的黑匣子开关装完就该打开。6. 装完怎么验证一段 Python 脚本跑通建模链路装完软件、配完首选项别急着翻书做产品设计的例子先用一段最短的脚本把「程序能起、几何内核能用、Python 能用、3D 视图能渲染」这四件事一次验完。打开 FreeCAD在视图菜单里把 Python 控制台调出来逐行或者整段粘进去import FreeCAD as App # 主程序模块文档、参数对象都从这里来 import Part # 几何内核模块验证建模链路是否可用 doc App.newDocument(smoke) # 新建文档命名方便在树视图里辨认 box Part.makeBox(10, 10, 10) # 10mm 立方体三个参数是长宽高 Part.show(box) # 把形状挂进文档3D 视图应立刻出现实体 doc.recompute() # 重算参数变化后拓扑才会刷新 print(App.Version()) # 打印版本确认解释器和主程序是同一套makeBox的三个参数分别是长、宽、高单位跟随首选项里的 MKS 设置这里就是毫米级的小方块。Part.show是把内存里的几何体转成文档对象只有这一步做完3D 视图里才看得见东西recompute在改参数后必须调用不调用的话树视图里的对象还是旧形状。App.Version()返回版本信息如果它和你从发布页下载的版本对不上说明系统里有多个 FreeCAD当前启动的不是你以为的那个。验证按这张表逐项对哪一项不对就回头查对应章节检查项操作期望结果不对时查程序启动打开 FreeCAD主界面完整出现第 4 章平台安装几何内核执行Part.makeBox无异常返回第 3 章安装完整性3D 渲染中键拖动旋转视角实体顺滑跟随2.2 节显卡与虚拟机Python 输出print(App.Version())控制台打印版本3.2 节重定向选项文件落盘保存为 .FCStd 并另存 STL两个文件都能生成第 5 章路径与权限最后一行的 STL 导出值得单独说一句因为它是「3D 打印」这条链路的第一环。导出走网格相关的工作台把实体转成网格再写出文件如果这一步报错先看保存路径有没有中文再看转换时网格精度参数是不是设得太细导致超时超内存。导出成功后拿切片软件打开看一眼尺寸对不对整条链路才算闭环。从那以后我每次装完 FreeCAD不管多急都强制走一遍这段脚本加这张表包括备份配置目录这一步。吃过的亏很具体一次是配置目录里残留了旧版本的界面布局重装三次都一样一次是路径带中文导致导出静默失败白画了两小时。这套动作五分钟能做完省下的是半天的来回折腾。希望帮到你。本文还有配套的精品资源点击获取
