freecad扩展功能需通过插件安装,主要方式有五种:一、addons manager在线安装;二、手动解压zip至mod目录;三、偏好设置添加自定义附件路径;四、python控制台调用api安装;五、git克隆源码部署。

如果您在FreeCAD中无法找到所需的专业建模功能,如紧固件库、高级装配或BIM支持,则很可能是缺少对应的第三方插件或工作台。以下是安装这些扩展组件的多种可行方法:
一、通过Addons Manager在线安装
这是最推荐的方式,适用于绝大多数用户,系统自动处理依赖、版本匹配与路径配置,全程无需手动干预。
1、启动FreeCAD后,点击顶部菜单栏的工具 > 插件管理器(Addon Manager)。
2、等待插件仓库加载完成,在搜索框中输入目标插件名称,例如Fasteners或Assembly4。
3、在结果列表中点击对应条目,查看描述、截图及兼容性说明。
4、确认无误后点击安装按钮,等待下载与配置完成。
5、安装结束后,重启FreeCAD,在工作台下拉菜单中即可看到新添加的工作台。
二、手动安装ZIP格式插件包
当插件未被收录于官方仓库、网络受限或需使用特定分支版本时,可采用此方式。插件文件将被直接部署至FreeCAD的Mod目录,由启动时动态加载。
1、从GitHub、Gitee或社区论坛下载插件的ZIP压缩包。
2、解压该ZIP文件,确保解压后得到的是一个完整文件夹(如Fasteners或assembly4),而非嵌套多层子目录。
3、定位FreeCAD的Mod目录:
Windows默认路径为%USERPROFILE%\Documents\FreeCAD\Mod;
macOS路径为~/Library/Application Support/FreeCAD/Mod;
Linux路径为~/.FreeCAD/Mod。
4、将解压后的插件文件夹整体复制到Mod目录内。
5、重新启动FreeCAD,检查工作台列表是否出现新条目。
三、通过偏好设置添加自定义附件路径
该方法适用于插件存放位置固定且不希望混入Mod目录的场景,例如团队共享插件库或开发调试阶段。FreeCAD会扫描所有注册路径下的子文件夹并识别为有效工作台。
1、启动FreeCAD,进入编辑 > 偏好设置 > 附件路径(Edit > Preferences > Addon Paths)。
2、点击添加按钮,浏览并选中包含插件文件夹的父级目录(例如D:\freecad-addons)。
3、确保该路径右侧的激活复选框已被勾选。
4、点击应用并关闭偏好设置对话框。
5、重启FreeCAD,系统将扫描该路径下所有子文件夹并加载其中符合工作台结构的插件。
四、使用Python控制台调用安装接口
适用于自动化部署、批量安装或集成进自定义启动脚本的高级场景。该方式绕过图形界面,直接调用AddonManager核心API执行安装逻辑。
1、在FreeCAD主界面中打开Python控制台(视图 > 控制台 或 Ctrl+Alt+P)。
2、输入以下命令并回车:
from AddonManager import AddonManager; AddonManager().install("Assembly4")。
3、若需安装多个插件,可依次执行对应命令,例如:
AddonManager().install("Fasteners")。
4、安装过程将在控制台输出日志,成功后提示“Installation completed”。
5、重启FreeCAD以使新工作台生效。
五、从Git仓库克隆并本地部署
适用于需要最新开发版、参与插件贡献或调试源码的用户。此方式获取的是原始代码,可能含未发布功能,但稳定性需自行验证。
1、确保系统已安装Git命令行工具,并能正常访问GitHub或Gitee。
2、打开终端(Windows可使用Git Bash),执行克隆命令:
git clone https://github.com/YorikvanHavre/FreeCAD-assemblies.git。
3、将克隆所得文件夹(如FreeCAD-assemblies)重命名为标准工作台名(如assembly4),并移入FreeCAD的Mod目录。
4、检查该文件夹内是否存在InitGui.py和Init.py两个必需文件,缺失则无法被识别为工作台。
5、重启FreeCAD,观察工作台列表是否更新。











