FreeCAD 0.16安装配置、参数化建模与STL验证指南

简介这是一份FreeCAD官方手册的中文翻译版PDF面向零基础入门者和希望系统梳理建模流程的进阶用户。全书循序渐进地讲解这款免费开源参数化3D建模软件从在Windows、Mac OS和Linux三个平台上安装、卸载到3D视图导航、首选项设置从产品设计建模、参数对象界面、导入导出其他文件格式到FEM分析、Cura与Slic3r切片插件、Python脚本编写、BIM建模、G代码生成和2D图纸绘制还附有电子表格、社区资源说明目录按模块编号便于检索。压缩包内为1个PDF文件约14.8MB单文件即含完整章节无需额外依赖。目前已有10960人学习下载。书中采用示例式讲解读者可对照完成从建模到3D打印准备、从界面定制到脚本扩展的完整流程适合放在手边随时查阅。1. 装 FreeCAD 前先对版本账0.16 稳定版和这份机翻教程手里这份 FreeCAD 中文教程是从官方 wiki 整理下来、再经过机器翻译的目录顺序被翻译工具搞得乱七八糟但章节骨架还在安装、界面、3D 视图导航、文档介绍、参数对象、工作台、导入导出、Python 脚本、FEM 分析、BIM、3D 打印准备一路排下来。我第一次照着它装的时候问题出在一个很不起眼的地方教程对应的是 0.16 稳定版我为了用上新功能下载了当天的开发版结果首选项里少了两项工作台名字也对不上跟着步骤点了半天找不到按钮。版本一旦对不上教程就只剩下一堆好看的目录。这套环境适合三类人第一次在本地安装 FreeCAD 的、想照着中文手册一步不落走一遍的、以及打算用 Python 脚本批量改模型参数的开发者。安装本身不难难的是装完之后能对上教程的每一个勾选项。2. Windows 与 macOS 安装0.16 安装包四页流程与权限放行两个平台都是一路点下一步但点和点之间有区别Windows 的安装程序会替你做很多决定macOS 什么都不替你做只负责在启动时拦你一下。把这两条路分开写是因为卡住新手的地方完全不一样。2.1 Windows从 .exe 到开始菜单的四页官方在发布页给的是预编译安装包按位数分 32 位和 64 位两个 .exe看自己系统位数下载包就行。安装程序对系统版本不挑从 Windows 7 起的系统都能装你不用先升级系统再装软件。整个过程一共四页双击运行、接受 LGPL 许可、确认安装路径、等进度条走完。第二页是许可协议。手册里写明这是少数可以放心点“接受”而不必逐字读的协议LGPL 的条款很宽松不限制你拿它做商业项目也不限制你生成的模型归属唯一明确禁止的是声称 FreeCAD 是你自己写的。第三页之后会出现一行说明不需要设置 PYTHONPATH 变量。很多新手会直接跳过这行字但它决定了后面能不能跑脚本。安装程序已经把内置 Python 环境和库路径写进了自己的配置文件你手动再设一个系统级 PYTHONPATHFreeCAD 启动时有可能优先去找系统里那个版本不一致的解释器脚本一跑就是一堆 import 报错而且报错位置跟真正的病因隔了十万八千里。我一般看到这行提示就当作安装完成后的第一条纪律不要去动环境变量。第四页会把 Python 解释器和一批依赖库一起装进去这些不是可选项是后面 Python 脚本、FEM 分析、网格转换的基础。装完开始菜单里出现入口双击能起来就算过了第一关。想确认装得完不完整用 PowerShell 看三件事主程序在不在、版本号对不对、依赖库数量正不正常。# 主程序路径按你实际选择的安装目录调整 $fc C:\Program Files\FreeCAD 0.16\bin\FreeCAD.exe # 1. 主程序是否落地返回 True 才算真的装上 Test-Path $fc # 2. 读文件版本用来核对装的是不是你以为的那个版本 (Get-Item $fc).VersionInfo.FileVersion # 3. 统计 bin 目录下的依赖库数量明显偏少多半是被安全软件静默拦了 (Get-ChildItem (Split-Path $fc) -Filter *.dll | Measure-Object).CountTest-Path 只回答“文件在不在”不回答“能不能跑”FileVersion 是最省事的版本核对手段比打开关于对话框翻菜单快得多第三条统计 dll 数量正常安装是几十个如果数出来只有个位数基本可以断定安装过程中安全软件静默拦掉了一部分文件这时候先别去排错把安装目录加进白名单再重装一遍更快。提示安装路径里不要带中文和空格。默认的 Program Files 没问题自己改成带中文的目录后面脚本里引用路径会非常难受。2.2 安装路径与开发版共存默认值为什么够用安装程序给的默认路径形如 C:\Program Files\FreeCAD 0.16这个默认值有两个好处权限清晰以后升级大版本时新旧目录天然分开不会互相覆盖。有人习惯把所有软件塞进一个 D 盘目录图省事但 FreeCAD 的安装目录和用户配置目录是两套东西安装路径改得太随意出问题时要多查一层才能确定是程序的问题还是配置的问题。稳定版之外还有预发布版发布形式是 .zip 或 .7z 压缩包解压就能用不走安装流程。这一点值得单独说你可以把稳定版装在默认路径、开发版解压到另一个目录两个版本同时存在互不干扰。想试新功能又怕弄坏主力环境这是成本最低的做法。# 看开发版解压后的目录结构可执行文件一般在 bin 下 Get-ChildItem D:\FreeCAD-dev -Directory # 直接启动开发版不经过开始菜单 D:\FreeCAD-dev\bin\FreeCAD.exe解压版没有注册表项、没有服务、没有快捷方式删掉整个目录就等于卸载干净。这既是优点也是坑它不会把自己注册成 .FCStd 文件的默认打开程序双击模型文件时系统可能还是拿稳定版打开看到界面和预期不一样别急着怀疑安装坏了先确认打开它的到底是哪个版本。2.3 macOS解压、拖进 Applications 和权限放行macOS 的流程比 Windows 还短问题出在最后一步。下载下来是压缩包解压得到 FreeCAD 应用把它拖进 Applications 文件夹就完事。Mac 上的包通常比 Windows 和 Linux 晚几个版本社区里用 Mac 的人少打包的人更少这不是你操作失误接受这个现实就行。会卡住人的是第一次启动。系统对不是来自 App Store 的应用有权限限制双击之后弹出一句“无法打开因为无法验证开发者”很多人到这一步就以为装失败了。其实应用已经装好只是被拦在门口。处理方式有两种右键点应用图标选“打开”在弹窗里再确认一次或者进系统设置的隐私与安全性页面找到拦截记录手动允许。前者快后者彻底放行之后后续启动就不再询问。# 确认应用确实落在 Applications 目录里 ls -d /Applications/FreeCAD.app # 看包内的可执行文件是否存在 ls /Applications/FreeCAD.app/Contents/MacOS/ # 移除系统给下载文件打的隔离标记等价于在设置里点一次仍要打开 xattr -d com.apple.quarantine /Applications/FreeCAD.appxattr 那条命令做的是把隔离属性摘掉效果和手动放行一致适合写进初始化脚本批量处理。注意它需要你对这个应用有写权限普通用户对 /Applications 下的应用通常够用不够就加 sudo。卸载就是把它从 Applications 拖到废纸篓Mac 上不留后台服务。3. Linux 安装与首选项落盘包管理器、社区 PPA 和六项必改设置Linux 的安装逻辑跟另外两个平台不一样官方不直接发安装包源代码交给各发行版维护者由他们打包进软件仓库。所以这里先解决“从哪装”再解决“装完先改哪些设置”顺序不能反。3.1 Linux 两条路软件管理器与社区 PPA最省事的路径是打开发行版自带的软件管理器搜索 freecad点安装。Ubuntu、Fedora、openSUSE、Debian、Mint 这些主流发行版都是这个流程界面长得不一样按钮就一个。装完别忘了在软件详情页给它评个分打包和做安装程序要花不少时间这一步对维护者来说是实打实的反馈。第二条路是社区维护的 PPA里面有稳定版也有每日构建。发行版仓库里的版本通常偏旧想跟新版就走这条。我不在这里固定写死具体地址因为 PPA 名称和启用方式在官方下载页上会变照抄网上几年前文章里的地址轻则装不上重则把软件源搞乱后面一堆包更新失败。# 先看发行版仓库里有没有、候选版本是多少 apt-cache policy freecad # 想跟社区维护的稳定版再挂 PPA # 地址以官方下载页给出的为准下面这行按实际名称替换 sudo add-apt-repository ppa:官方维护的 PPA 名称 sudo apt update sudo apt install -y freecad # 装完核对版本和二进制位置 freecad --version which freecadapt-cache policy 的输出里看 Candidate 那一行那是 apt 认为该装的版本先看清楚再决定要不要挂 PPAadd-apt-repository 会把源写进 /etc/apt/sources.list.d 并自动导入签名-y 跳过确认适合写在部署脚本里freecad --version 打印版本号是最快的验证which 告诉你二进制落在哪个路径方便后面写桌面快捷方式或者做多版本切换。注意不要同时挂多个来源的 FreeCAD 源。发行版仓库一份、PPA 一份apt 会按优先级挑一个但版本混装之后依赖关系容易打架出问题极难排查。3.2 首选项第一组语言、自动加载、启动时建文档装完第一次打开先别急着建模型去编辑菜单下的首选项把几项定下来。这些设置写进用户配置目录以后升级版本也还在属于一次设置长期受益。第一项是语言。FreeCAD 默认跟随系统语言中文系统一般直接就是中文界面。但中文翻译的完整度不如它那五六种主语言有些菜单项会中英混排甚至直接显示英文原文。这不是装坏了是翻译还没覆盖到。想核对教程里的英文术语把语言临时切回英文是常用手段切完重启生效。第二项是自动加载模块。默认情况下启动会显示开始中心页面里面有最近打开的文档、新建入口和一堆快捷方式。如果你习惯直接进某个工作台干活可以在这里改掉起始行为。第三项是启动时创建文档。它和上一项是搭配用的勾上之后FreeCAD 启动时直接新建一个空文档并进入你指定的工作台跳过开始中心。做重复性建模的时候这个组合能省下每天十几次点击。# Linux 上用户配置目录大致在这两个位置之一找到 Config 文件即可 ls ~/.FreeCAD/ ls ~/.config/FreeCAD/ # 动设置之前先备份改坏了能秒回退 cp -r ~/.FreeCAD ~/.FreeCAD.bakFreeCAD 的用户配置和历史记录放在用户目录下不同发行版和版本可能落在 ~/.FreeCAD 或 ~/.config/FreeCAD。改动前复制一份备份比出问题以后再回忆自己改了什么强得多。Windows 上对应位置在用户目录的 AppData\Roaming\FreeCADMac 上在用户目录的库目录里。3.3 首选项第二组崩溃恢复、创作许可、Python 输出、单位第四项是存储选项。FreeCAD 处理的是复杂几何参数一多、做布尔运算的时候崩溃不算稀罕事官方手册里也直说它“可能会不时崩溃”。存储页有一组自动保存和恢复相关的开关把它打开崩溃之后至少还有一份能捞回来的文档。这项属于典型的后悔药平时完全感觉不到它的存在出事那天能救回几小时的活。第五项是创作和许可。新建文件时可以带一份默认的版权与许可信息手册建议从一开始就用偏宽松的开放许可方便文件在社区里流转。做团队协作的话建议统一设定免得交付时一个个补。第六项是把 Python 消息重定向到输出视图。这一页有两个勾手册明确建议都打开。原因很直接写脚本的时候报错信息、警告、print 输出默认可能被吞掉界面上什么反应都没有你只能靠猜。勾上之后报告视图里能看到完整信息流排错从盲猜变成看日志。这也是我装完 FreeCAD 后必改的一项。第七项是单位。默认的 MKS 制跟手册后面所有示例是对齐的跟着教程走就别动它。做机械件习惯毫米的等工作台用熟了再在单位页切或者建模时直接按毫米填导出前再核对一次尺寸。4. 界面与工作台配置3D 视图导航、工作台切换和参数对象首选项定完之后接下来就是把这套界面调成自己能用的样子。这一章解决三件事怎么在 3D 空间里不迷路、怎么在十几个工作台之间快速切换、怎么用 Python 直接操作参数对象。4.1 3D 视图导航三个鼠标键各自管什么一句话说清 3D 空间任何一个点用三个数就能定位X、Y、Z建模软件做的就是让你在二维屏幕上摆弄这三个数。FreeCAD 的 3D 视图是理解后面所有操作的前提导航不顺手后面每一步都别扭。导航方式按平台大致分几套预设可以在首选项的显示页里切换。默认那套的操作是按住中键拖动旋转视图中键配合 Shift 平移滚轮缩放。触控板用户会难受一点可以切到另一套预设用组合键平移各平台预设的名字在显示页里写得很清楚。视图右上角有个导航立方点它的面得到正视点棱得到侧视点角得到等轴测视角。判断自己有没有把视图转晕最快的办法就是点一下立方体的正面视图立刻归位。# 用 Python 控制视图比拖鼠标精确也方便写成固定视角脚本 import FreeCADGui as Gui view Gui.activeDocument().activeView() view.viewAxonometric() # 切到等轴测视角最常用的观察角度 view.viewTop() # 切到俯视画草图前先摆正 view.fitAll() # 缩放到全部对象可见对象跑出视野时用viewAxonometric 和 viewTop 这两个方法只改相机方向不改模型本身随便点fitAll 在对象被移到很远的地方时特别有用很多人以为模型没了其实是视图没跟过去。这三个方法可以写进一个启动脚本每次打开文件自动摆正视角。4.2 工作台切换与界面自定义工作台是 FreeCAD 组织功能的方式每个工作台是一套针对某类任务的工具集零件设计、草图、网格、工程制图、建筑、FEM 分析各占一个。手册里专门有一节讲所有工作台的分工装完之后建议挨个点开看一眼不用记住混个脸熟以后遇到“这个功能在哪”能想起来去哪个工作台找。切换用工具栏上的下拉框也可以自定义。常用的几个命令可以拖到自建工具栏上参数对象界面涉及属性编辑器的显示与隐藏在视图菜单里开关。界面布局改乱了的恢复办法是首选项里那一项重置比一个个拖回去快。提示不同工作台的操作对象类型不通用。在零件设计工作台建的对象拿去做建筑建模得先确认对象类型是否兼容不兼容时对象会显示成灰色或者操作按钮全部禁用。4.3 参数对象属性读写和 Python 控制台参数化建模的核心是“形状由参数控制”。一块砖由长宽高三个参数决定改一个数几何跟着重算。FreeCAD 把这个关系做成了对象属性属性编辑器里能看到Python 控制台里也能直接改。控制台在视图菜单里打开用起来比点界面快得多。import FreeCAD as App doc App.newDocument(BrickDemo) # 新建一个空文档 brick doc.addObject(Part::Box, Brick) # 加一个长方体参数对象 brick.Length 200.0 # 长单位跟随首选项里的单位制 brick.Width 100.0 # 宽 brick.Height 60.0 # 高 brick.Placement.Base App.Vector(0, 0, 0) # 放置基准点控制对象在世界坐标里的位置 doc.recompute() # 关键一步参数改完必须重算几何才会更新 print(brick.Shape.Volume) # 读几何属性验证参数是不是真的生效 doc.saveAs(/tmp/BrickDemo.FCStd) # 存盘路径按自己的环境改addObject 的第一个参数是对象类型Part::Box 是内置的实体图元第二个参数是内部名称后面引用都靠这个名字Length、Width、Height 是对象自带的属性赋值之后不会立刻改变几何必须调 recomputeShape 是几何结果的入口Volume、Area、BoundBox 都从这个属性读saveAs 存成 .FCStd这是 FreeCAD 的原生格式文件里同时存参数和几何。参数对象还能加自定义属性加完之后属性编辑器里多一栏别的对象可以引用它# 四个参数分别是属性类型、属性名、属性组、显示用描述 brick.addProperty(App::PropertyString, Note, Base, 备注) brick.Note 第一块参数砖 doc.recompute()addProperty 加的是元数据不会影响几何但它是构建参数化模型之间引用关系的基础。手册里讲“读取属性”“写属性”的章节用的就是这个机制。属性改完之后同样的参数值可以复用到另一个对象上改一处全联动这才是参数化建模真正省事的地方。5. 安装后排错五个翻车现场的现象、原因和救法安装过程本身很少真正失败失败都发生在装完之后的头一个小时。下面五条是我自己遇到过、也帮别人处理过的典型情况按现象、原因、解决三段来记遇到了直接对号入座。5.1 启动之后 3D 视图一片空白或者直接闪退现象主界面打开了菜单在、工具栏在中间的 3D 视图区域全黑或者全灰点什么都没反应严重的时候启动几秒后直接退出。原因大概率在显卡和 OpenGL 上。手册里专门提过一句在虚拟机里安装 FreeCAD性能可能很低某些情况下由于 OpenGL 的限制3D 视图直接没法用。虚拟机自带的图形驱动对 OpenGL 的支持往往只到很老的版本FreeCAD 需要的那套渲染能力它给不了。另一个可能是显卡驱动版本太旧或者是双显卡笔记本默认用了核显跑。解决分三步走先确认是不是虚拟机环境如果是换物理机安装是最省事的方案物理机上看显卡驱动更新到厂商发布的最新稳定版双显卡机器在显卡控制面板里把 FreeCAD 的可执行文件指定为独立显卡运行。做完这三步还不行去首选项的显示页试试软件渲染相关的选项性能会下降但至少能打开界面看清菜单。5.2 Python 脚本报错报告视图里什么都没有现象在控制台里跑一段脚本回车之后什么都没发生对象没建出来也不报错界面上安静得像什么都没执行。原因是 Python 的消息重定向没开。FreeCAD 默认把脚本的输出和异常往内部通道里送不显示在界面上界面上的报告视图是空的。这是最容易让人怀疑自己代码写错的一项实际情况是代码错了但你看不到错误。解决编辑菜单进首选项找到 Python 相关的页面把“将 Python 消息重定向到输出视图”这一类选项勾上重启 FreeCAD。之后再看报告视图报错行号和异常类型都会打出来。我现在的习惯是装完软件第一件事就是勾这个不然后面每次调试都要浪费十分钟。5.3 中文菜单和教程对不上找不到对应按钮现象教程里写“点编辑菜单下的首选项”你的界面里那一项是英文或者教程里叫“零件设计”你的下拉框里叫“零件”。更麻烦的是教程本身是机器翻译的同一个工作台在正文和目录里译名不一致。原因有两个叠加一是中文翻译的覆盖率不如那五六种主语言部分菜单项没有译文直接显示英文原文二是这份机翻手册里专有名词的译法本身就不统一。这不是装错了别去重装。解决把界面语言临时切到英文对照教程里的操作描述找到对应菜单记下英文名再切回中文。长期做法是在首选项里保留中文但对常用菜单记住英文关键词搜索官方 wiki 时用英文名命中率高得多。教程里那些明显不通顺的句子对着英文原文看一遍比硬猜快。5.4 装完附加内容之后启动变慢甚至报错现象通过附加内容机制装了几个工作台或者插件重启之后启动时间明显变长有时候启动到一半卡住控制台里刷出一串跟插件相关的错误。原因是插件和主程序的版本不匹配。附加内容是社区维护的更新节奏跟主程序不一致稳定版配最新插件、或者开发版配老插件都可能出问题。更隐蔽的情况是插件装了一半失败了残留的目录还在被加载。解决找到用户配置目录下的 Mod 文件夹里面每个子目录对应一个插件把最近装的那几个移出去重启验证。确认是哪个插件的问题之后要么等它更新要么回退主程序版本。装插件这件事我的原则是一次只装一个装完立刻重启验证出问题能立刻定位到具体是谁。5.5 Mac 打不开、卸载之后配置还在现象一Mac 上双击应用没反应或者弹窗提示无法验证开发者。这个是系统权限拦截不是安装失败处理方式在 2.3 节写过右键打开或者在隐私与安全性里放行。现象二卸掉重装之后之前的设置、最近打开的文件、装过的插件全都还在重装完的界面跟自己印象里的“全新安装”完全不一样。原因是卸载只删了程序本体用户配置目录没动。Windows 上在用户目录的 AppData\Roaming\FreeCADLinux 上在 ~/.FreeCAD 或 ~/.config/FreeCADMac 上在用户目录的库目录里。想要真正干净的初始状态卸载后手动把配置目录改名或删掉。反过来这条也是后悔药升级大版本前先备份配置目录新版本用不惯可以连配置一起回退。6. 验证跑通一块参数砖从建模走到切片器装完不验证等于没装。我习惯用一个最小闭环来确认整套环境是通的建一个参数化实体改一次参数看到几何变化转成网格导出 STL最后用切片软件打开确认尺寸。这条链路跑通说明安装、Python 支持、网格模块、导出模块全都正常。import FreeCAD as App import MeshPart, Mesh doc App.ActiveDocument brick doc.getObject(Brick) # 参数化实体转网格LinearDeflection 越小网格越密文件越大 mesh_obj doc.addObject(Mesh::Feature, BrickMesh) mesh_obj.Mesh MeshPart.meshFromShape( Shapebrick.Shape, LinearDeflection0.5, # 线性偏差常规打印件 0.3 到 1.0 之间够用 AngularDeflection0.3, # 角度偏差曲面多的模型适当调小 RelativeFalse ) doc.recompute() # 导出 STL路径按自己环境改 Mesh.export([mesh_obj], /tmp/Brick.stl)meshFromShape 的两个偏差参数决定网格精度数值越小三角形越密导出的 STL 单位是毫米跟切片软件的默认假设一致。导出后在切片软件里打开看三个数长宽高是不是 200×100×60模型有没有破面切片预览里有没有空层。三项都对这套环境就可以放心用了。检查项预期结果不对时先看哪里实体生成Brick.Shape.Volume 有正常数值参数是否赋值、有没有 recompute参数联动改 Length 后体积跟着变是否漏了 recompute网格转换BrickMesh 有三角形面片网格模块是否装全、偏差参数是否过大STL 导出文件大小合理、切片软件能打开导出路径权限、单位设置尺寸复核切片软件里量出来 200×100×60首选项单位制是不是被改过从那以后我每次装完 FreeCAD不管多急都强制走一遍这条链路宁可多花十分钟也不想在截稿前一晚发现导出的 STL 尺寸差了一个数量级。希望这套流程能帮到你。本文还有配套的精品资源点击获取