简介这份《FreeCAD中文教程-翻译版本》面向零基础到进阶的三维建模学习者尤其适合希望用免费开源工具替代商业CAD软件的产品设计、机械与建筑方向从业者及学生。内容源自FreeCAD官方wiki的体系化整理并经过翻译以更循序渐进的示例化节奏讲解参数化建模思路弥补原wiki信息庞杂、新手难以导航的不足。资源包内为1个PDF文件大小约14.8MB单文件即涵盖完整手册便于离线阅读与检索。正文覆盖软件在Windows、Mac OS、Linux上的安装与卸载、3D视图导航、基本首选项设置、参数对象界面、自定义界面、导入导出其他文件格式、传统CSG建模与2D绘图、工作台使用、Slic3r与Cura插件、为3D打印准备模型、FEM分析、BIM建模、电子表格、生成G代码以及Python脚本编写与属性读写等模块并说明LGPL许可下数据归属与自由分发等要点。已有10990人学习适合按章节系统通读也可作为建模过程中随手查阅的参考手册。1. 从手册第 1.2.2 节开始先装对 FreeCAD再谈建模手上这份 FreeCAD 中文教程翻到第 1.2.2 节标题就五个字在 Windows 上安装。照着点完 .exe进度条走完开始菜单多了个图标我以为收工了。结果第一次打开界面全英文3D 视图一片灰白单位还是英寸画个 20 毫米的方块属性栏显示 0.79。折腾半小时才反应过来安装向导只负责把程序放进硬盘语言、单位、崩溃恢复这些全在「编辑 → 首选项」里等着你。这份 FreeCAD 中文教程是从官方文档 wiki 转写而来的写作对象是当时的稳定版 0.16讲的是参数化建模那一套对象由参数控制砖块的高度、宽度、长度都是可以随时改的属性。教程第 1.3 章还专门讲了 3D 打印的准备流程从建模到切片器导出。但所有这些内容都有一个前提——环境得先装对。装错了后面每一节的菜单路径都对不上越读越怀疑自己。这篇记录的就是我按教程装完三个平台、改完首选项、又把几个坑填回去的过程适合第一次接触 FreeCAD、想跟着手册一步步走的人。2. 装前先对表0.16 手册配哪个版本、三个平台怎么选包2.1 手册锁在 0.16版本差一截会怎样教程原文写得很清楚本手册是为 FreeCAD 的当前稳定版本编写的即版本 0.16。这句话决定了你后面读教程时的所有预期。0.16 是一个相当早的版本工作台的划分、菜单项的位置、属性编辑器的布局和现在能下载到的版本已经不是一回事了。差一截会差在哪我列几个实际会遇到的工作台名字变了Arch 相关的建筑建模内容后来并入 BIM 工作台教程第 1.4.2 节讲的 BIM 建模在新版里入口位置完全不一样任务面板的停靠方式改过教程截图里在左侧的面板新版可能在右侧或者折叠起来首选项的页签名字也动过教程第 1.2.4 节让你去「编辑 → 首选项」里找的几个选项在新版里可能换了分组。那到底装哪个版本。我的做法是如果你打算从头到尾跟读这本手册就装 0.16 对应的安装包或者至少装一个同大版本的稳定版把界面差异降到最低如果你只是想拿 FreeCAD 干点活手册当参考书翻那就装当前稳定版读教程时记住「菜单路径可能对不上」这件事遇到找不到的项先在工作台下拉框里扫一遍。开发版是另一回事它通常以 .zip 或 .7z 压缩包发布不需要安装解压出来双击里面的可执行文件就能跑好处是能和稳定版放在同一台机器上互不干扰坏处是崩溃概率高不适合当唯一环境。2.2 三平台安装包对照exe、软件仓库、zip三个平台的获取方式差别挺大装之前先对着这张表确认自己该下什么能省掉一轮返工。平台获取方式包格式是否需要管理员权限关键注意点Windows官方下载页面.exe 安装程序32 位 / 64 位是从 Windows 7 起都支持选对位数Linux发行版软件管理器 / 社区 PPA / 源码编译发行版包deb、rpm 等是sudo仓库版本可能落后或超前于手册macOS官方下载页面.zip 压缩包否拖拽到 Applications包通常比其他平台落后几个版本Windows 和 macOS 官方提供预编译好的安装程序或压缩包Linux 则不同源码交给各发行版的维护者由他们打包成适合该发行版的安装包所以你一般直接在软件管理器里搜就行。这也是为什么同一天在三台机器上装版本号可能三个样。2.3 虚拟机与 OpenGL装之前先确认能画得动教程原文有一句提醒很容易被跳过如果是在虚拟机里装 FreeCAD性能可能较低某些情况下由于 OpenGL 的限制甚至无法使用。这不是吓唬人。FreeCAD 的 3D 视图依赖 OpenGL 渲染虚拟机默认的图形加速往往不够表现就是界面能出来、菜单能点但 3D 视图区域一片空白或者严重拖影。判断办法很简单装完先新建一个文档随便建个立方体用鼠标中键按住拖动旋转。如果转不动、或者画面撕裂先别怀疑软件装坏了去虚拟机设置里把 3D 加速打开给显存调大一点再重启虚拟机试一次。还是不行就换物理机装这是最省时间的做法。实体机上同理显卡驱动太旧也会出这个问题装之前顺手把驱动更新一遍比装完再排查划算。3. 三平台安装实操Windows 六步向导、Linux 仓库与 PPA、macOS 拖拽3.1 Windows安装向导六步与捆绑的 PythonWindows 上的流程最直白教程里拆成了六步我按实际操作顺序复述一遍顺便把每步该注意的点标出来。第一步从下载页面选对应你 Windows 位数的安装包32 位系统选 32 位64 位选 64 位。位数选错的表现是安装程序直接拒绝运行或者装完打不开不会有太明确的提示所以这一步别凭感觉。第二步双击下载好的 .exe。第三步接受 LGPL 许可条款——教程在这里开了个玩笑说这可能是少数几个你可以安全地直接点「接受」而不用读完全文的许可之一因为它没有隐藏条款。第四步安装路径保持默认即可除非你的 C 盘确实紧张改路径时注意不要带中文和空格。第五步不需要设置 PYTHONPATH 变量除非你要做高级安装这条下一小节单独说。第六步安装过程中会顺带装上几个捆绑组件其中就包括 Python 编程环境装完在开始菜单里能找到 FreeCAD。装完别急着开先用 PowerShell 确认一下装到哪了、装的是什么版本# 列出 FreeCAD 的安装目录确认实际落盘位置 Get-ChildItem C:\Program Files\FreeCAD* -Directory | Select-Object FullName # 从卸载注册表项里读版本号和安装路径 Get-ItemProperty HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\* | Where-Object { $_.DisplayName -like *FreeCAD* } | Select-Object DisplayName, DisplayVersion, InstallLocation第一段命令解决的是「我到底装哪了」第二段解决的是「我装的是哪个版本」。两条都用Get-ChildItem和Get-ItemProperty这两个标准 cmdlet不依赖任何第三方工具。输出里的DisplayVersion就是版本号拿它和教程封面写的 0.16 对一下差太远的话后面读教程时心里要有数。3.2 WindowsPYTHONPATH 为什么不要动这是我在 Windows 上见过最多的翻车点值得单独拎出来说。FreeCAD 内部嵌了一个 Python 解释器安装包里捆绑了自己的标准库和一堆模块脚本功能、参数化对象、宏命令全靠它。如果你在系统环境变量里设了PYTHONPATH指向系统里另装的那套 PythonFreeCAD 启动时就会顺着这个变量去加载路径下的包轻则某个模块导入失败重则启动直接报 DLL 加载错误。典型的触发场景是机器上装过 Anaconda 或者别的 Python 发行版安装时勾了「加入 PATH」之后再用 FreeCAD 的 Python 控制台就会看到一堆版本冲突的报错。教程原文那句「不需要设置 PYTHONPATH 变量除非你打算做一些高级的安装」说的就是这个意思。所谓高级安装指的是你自己编译扩展模块、或者要把 FreeCAD 当库嵌到外部 Python 程序里那种情况才需要手动指路径。如果你已经踩了这个坑处理办法是去「系统属性 → 环境变量」里把用户级和系统级的PYTHONPATH都删掉然后重启 FreeCAD。删之前记一下原来的值万一别的工具依赖它还能加回去。我一般还会顺手确认 PATH 里没有把某个 Python 目录排在系统目录前面避免同类问题再次出现。3.3 Linux软件管理器一键装与 PPA 通道Linux 这边的思路和 Windows 完全不同不用下安装包直接在发行版自带的软件管理器里搜 freecad点安装就完事。Ubuntu、Fedora、openSUSE、Debian、Mint 这些主流发行版都是这个流程界面长得不一样本质一样。装完别忘了给个评分教程原文特意提了一句因为打包和维护确实要花时间。命令行党可以直接走 apt# 先刷新索引再查仓库里 freecad 的实际版本和来源 sudo apt update apt-cache policy freecad # 确认版本可接受后再安装 sudo apt install freecadapt-cache policy这步很关键它会把候选版本、已安装版本、版本来源列出来。如果候选版本比手册的 0.16 新太多你就要做好菜单对不上的心理准备如果比 0.16 还老说明这个发行版的仓库更新慢考虑换 PPA。Ubuntu 及其衍生版上FreeCAD 社区维护了 PPA里面同时有稳定版和开发版。用法是先加源再装# PPA 地址以社区页面公布的为准这里用占位符表示 sudo add-apt-repository ppa:社区维护的 PPA 地址 sudo apt update sudo apt install freecad加 PPA 之前想清楚一件事它会把系统的 FreeCAD 包来源换掉以后apt upgrade升的是 PPA 里的版本不再是发行版仓库的版本。想换回去得用ppa-purge清理。开发版每日构建也在类似的通道里适合想试新功能的人但不建议装在工作用机上。源码编译这条路教程也提了我的建议是新手先别碰依赖项一长串编译一次半小时起步出错了还不好定位。3.4 macOS解压拖拽与权限放行macOS 的安装是三平台里最轻的下载对应版本的 zip 压缩包打开下载文件夹解压把 FreeCAD 应用从解压出来的目录拖到 Applications 文件夹完事。没有向导没有许可页也没有路径选择。真正的坎在第一次启动。系统对不是从 App Store 来的应用有权限限制双击可能直接弹「无法打开」或者「已损坏」。这不是包坏了是 Gatekeeper 在拦。解决办法是去「系统设置 → 隐私与安全性」往下翻到安全性一栏会看到一条关于 FreeCAD 被阻止的提示点「仍要打开」再确认一次之后就能正常启动了。装完可以用两条命令确认状态# 确认应用确实在 Applications 下 ls -d /Applications/FreeCAD.app # 从 Info.plist 读版本号和教程对应的版本对一下 defaults read /Applications/FreeCAD.app/Contents/Info.plist CFBundleShortVersionString第二條命令读的是应用包里的元数据不依赖应用本身能不能启动所以哪怕 Gatekeeper 还在拦也能先确认版本。教程里还有一句提醒值得记住Mac 平台可用的软件包通常比其他平台落后几个版本因为社区里用 Mac 的人少。这意味着你在 Mac 上装到的版本可能比同期的 Windows 版还老跟手册反而更接近算是意外的好处。3.5 卸载与稳定版、开发版共存卸载在三个平台都很简单教程写得很干脆Windows 走控制面板的标准「删除软件」Linux 用装它时的那个软件管理器删Mac 直接把它从 Applications 文件夹里拖进废纸篓。没有额外的注册表清理也没有残留服务。但有个细节教程没展开卸载不会删你的配置文件和用户数据。Windows 上残留在%APPDATA%\FreeCADLinux 在用户主目录下的配置目录里Mac 在~/Library/Preferences/FreeCAD。下次重装这些配置会被继承包括你之前改坏的语言设置和单位制。所以重装前如果怀疑是配置问题先把配置目录改名备份让程序以全新状态启动比反复卸载重装有效得多。开发版和稳定版共存是另一个实用技巧。开发版是 zip 或 7z 包解压到任意目录双击里面的可执行文件就能跑跟已安装的稳定版互不影响。我一般在 D 盘或家目录下建一个freecad-dev文件夹放它想试新工作台的时候开这个日常干活还是用稳定版。4. 首次启动先改七项中文界面、崩溃恢复、MKS 单位4.1 语言与自动加载模块装完第一次打开先别急着建模花十分钟把首选项过一遍。入口在「编辑 → 首选项」教程第 1.2.4 节列的七项我按影响程度重新排了序。语言排第一。FreeCAD 会自动跟随操作系统语言但如果你系统是英文的界面就是英文。教程说得很实在FreeCAD 几乎完全翻译成了五六种语言其他语言目前只翻译了一部分。中文属于哪一档不同版本不一样你可能会看到中英混排的界面菜单是中文、某个对话框里还是英文单词。这不是装坏了是翻译覆盖率的问题。想改语言就在首选项第一页的下拉框里选「简体中文」重启生效。自动加载模块排第二。默认情况下 FreeCAD 启动会显示开始中心页面你可以在这里勾选启动时自动加载哪些工作台。工作台装多了会拖慢启动我的习惯是只留常用的两三个比如 Part、Part Design 和 DraftBIM 和 FEM 用到时再手动切。4.2 启动时创建文档与存储选项第三项是启动时创建文档。它和上面的自动加载模块是配合使用的勾上之后FreeCAD 启动直接进你选定的工作台并新建一个空文档跳过开始中心。日常干活这个选项很省事但如果你经常要打开最近文件跳过开始中心反而少了个入口看个人习惯。第四项是存储选项这一项最值得认真对待。教程原文说和任何复杂的应用程序一样FreeCAD 可能会不时崩溃。这句话背后是血泪经验参数化建模的文档里一个特征出错可能导致整个重算失败程序直接退出没保存的部分就没了。存储选项里可以配置自动保存的间隔、临时文件的位置、崩溃后恢复的相关设置。我的建议是把自动保存间隔调到 5 到 10 分钟临时目录指向空间充足的盘符。配置本身也存在文件里改坏了有后悔药# 0.16 时代用户配置默认在 ~/.FreeCAD ls -la ~/.FreeCAD # 较新版本迁移到 XDG 配置目录两个都看一眼 ls -la ~/.config/FreeCAD # 改动前先整包备份出问题直接还原 tar -czf freecad-config-backup.tar.gz ~/.FreeCAD 2/dev/null \ || tar -czf freecad-config-backup.tar.gz ~/.config/FreeCAD这三条命令的作用分别是定位旧配置目录、定位新配置目录、打包备份。tar那条用了||做兜底第一个目录不存在就备份第二个两个都存在时只备份第一个。备份完再动首选项心里踏实。真改出问题了把备份包解回去覆盖原目录重启即可不用卸载重装。4.3 创作许可与 Python 消息重定向第五项是创作和许可。这里设置的是新建文件的默认元数据包括作者信息和默认许可证。教程建议考虑用更友好的 copyleft 许可证比如知识共享一类的从一开始就让文件可共享。这个设置不影响功能但如果你做的模型要发给别人或者传到公开仓库提前设好省得以后一个个改。第六项是把 Python 消息重定向到输出视图教程说这两个选项总是值得勾上因为运行特定 Python 脚本出问题时它们能让你在报告视图里看到问题。这一点我深有体会。FreeCAD 的 Python 控制台默认情况下报错信息可能一闪而过或者根本不显示脚本跑完没反应你不知道是成功了还是静默失败了整个就是个黑匣子。勾上这两个选项之后报错会老老实实打印在报告视图里哪一行、什么异常一目了然。写宏、跑批量脚本之前这项必须先开。4.4 单位制为什么建议先留在 MKS第七项是单位。教程的建议是后面跟着例子做的时候留在 MKS。MKS 就是米、千克、秒这套单位制长度默认单位是毫米。为什么建议先别改。因为教程里所有示例的尺寸都是按这套单位写的你中途切成英制或者厘米输入 20 的时候心里想的是 20 毫米程序理解成 20 英寸模型直接大 25 倍导出到切片器才发现整个打印平台都放不下。等把教程的建模部分跟完对数值和单位的对应关系有感觉了再按自己的习惯改。改的时候注意FreeCAD 的单位设置影响的是显示和输入解析已经建好的模型几何不会变所以切换单位不会把已有模型改坏但新输入的值会按新单位解析。七项过完可以对照这张表自查一遍首选项位置建议值作用语言首选项第一页简体中文界面语言重启生效自动加载模块首选项 → 常规只留常用工作台加快启动启动时创建文档首选项 → 常规按习惯开关跳过开始中心存储选项首选项 → 常规自动保存 5~10 分钟崩溃恢复创作和许可首选项 → 常规按发布需求设新建文件默认元数据Python 消息重定向首选项 → 输出窗口两项都勾脚本报错可见单位首选项 → 单位先留 MKS避免尺寸误解5. 排查装完打不开、界面英文、3D 视图空白的处理顺序5.1 安装阶段的两个坑现象一装完开始菜单找不到图标或者点开提示缺少 DLL。原因通常是位数装错或者机器上残留了旧版本的 FreeCAD新安装写注册表时被旧项干扰。解决办法是先确认系统位数64 位系统装 64 位包然后去控制面板把所有名字里带 FreeCAD 的条目全部卸掉包括旧版本的残留再重装。装完用 3.1 节那两条 PowerShell 命令确认安装路径和版本号路径不对说明装到了别处。现象二Linux 上用 apt 装完版本比手册老一大截工作台少了好几个。原因是发行版仓库的更新节奏慢尤其是 LTS 版本的系统仓库里的 FreeCAD 可能停留在两三年前。解决办法是换 PPA 通道或者去官方下载页面找对应的发行版包手动装。换 PPA 之前先用apt-cache policy freecad记下当前版本装完再查一次确认来源已经切换不然可能以为换了其实没生效。5.2 启动与显示阶段的三个坑现象三双击图标没反应或者启动画面一闪就退。原因大概率在图形环境显卡驱动太旧、虚拟机没开 3D 加速、或者系统里同时存在多个 OpenGL 实现互相打架。解决办法按顺序来先更新显卡驱动重启虚拟机的话把 3D 加速勾上、显存调大还不行就在启动时加参数禁用硬件加速试试能起来就说明是渲染路径的问题。这一步别急着卸载重装卸载解决不了驱动问题。现象四界面是英文首选项里改成中文重启后还是英文。原因有两个可能一是翻译文件本身没装全某些发行版的包会把语言文件拆成单独的包二是配置文件里残留了旧的语言设置覆盖了你的选择。解决办法是先确认安装目录下有没有中文翻译文件Linux 上可以查一下相关的语言包是否已安装再就是把 4.2 节备份过的配置目录整体移走让程序以默认配置启动重新选一次语言。中英混排的情况属于翻译覆盖率问题改不了只能适应。现象五菜单能点、面板正常但 3D 视图区域一片空白。原因通常不是装坏了而是当前没有可显示的对象或者工作台没切对。FreeCAD 启动后默认可能停在开始中心或者某个不显示 3D 内容的工作台新建文档、切到 Part 工作台、建一个立方体视图才有东西可画。如果建了立方体还是空白检查视图菜单里是不是把显示模式切成了线框而模型又特别小用视图菜单里的「fit all」缩放一下。这一条我踩过折腾了半天驱动最后发现只是没建对象。6. 装完怎么验证十分钟跑通「建模—改参—导出」最小闭环装完、配完、坑也填完了最后一步是验证这套环境真的能用。我的验证方法不是看界面能不能打开而是跑一个最小闭环建一个参数化对象改一个参数看几何有没有跟着变再导出一个 STL 文件确认输出链路通。整个过程十分钟以内。先新建文档切到 Part 工作台用工具栏建一个立方体。然后打开 Python 控制台把下面这段贴进去import FreeCAD # 新建文档名字随便取验证完可以删 doc FreeCAD.newDocument(VerifyDemo) # 建一个参数化立方体长宽高都是可改的属性 box doc.addObject(Part::Box, Box) box.Length 20.0 # 单位跟随首选项MKS 下是毫米 box.Width 20.0 box.Height 10.0 # 触发重算参数才会真正作用到几何上 doc.recompute() # 打印体积20*20*10 应该得到 4000 立方毫米 print(Volume:, box.Shape.Volume) # 改一个参数再重算验证参数化是否生效 box.Height 30.0 doc.recompute() print(Volume after change:, box.Shape.Volume)这段代码的逻辑很直接addObject创建对象三个尺寸属性赋值recompute触发几何重算Shape.Volume读体积。第一次打印应该是 4000.0把高度从 10 改成 30 之后应该变成 12000.0。如果两个数对得上说明参数化建模这条链路是通的教程第 1.2.3 节讲的「对象由参数控制、创建后随时可改」在你机器上成立。如果报AttributeError大概率是工作台没切对或者对象类型名写错如果体积是 0检查recompute有没有执行。接着验证导出。选中这个立方体用「文件 → 导出」格式选 STL存到桌面。导出完去看文件大小一个 20×20×30 的立方体STL 文件通常几 KB 到几十 KB如果导出的是 0 字节说明网格生成失败回去看报告视图里的报错——这也是为什么 4.3 节那两个 Python 消息重定向选项必须勾上。最后一张自查表三步都过了就算环境合格验证项预期结果不通过先看哪Python 控制台建对象无报错体积 4000.0工作台是否切到 Part改参数后重算体积变为 12000.0recompute 是否执行导出 STL文件几 KB 以上可被切片器打开报告视图报错、网格设置从那以后我每次装完 FreeCAD不管多急都强制走一遍这个闭环再开始干活。因为界面能打开不代表 Python 环境正常Python 正常不代表导出链路通这三步任何一步出问题都会在你画了两小时模型、准备切片打印的时候才暴露出来。早点花十分钟比事后找后悔药强。希望帮到你。本文还有配套的精品资源点击获取
