freecad

项目地址： https://github.com/FreeCAD/FreeCAD

官网： https://www.freecad.org/

官方文档： https://wiki.freecad.org/Main_Page

Python API： https://wiki.freecad.org/FreeCAD_Scripting_Basics

许可证： LGPL-2.1-or-later

最新版本： 1.1.4（2026-09-28，1.1.x 系列最后一个维护版本；26.3 系列仍为 RC，截至 2026-11，见 GitHub Releases）

包管理器： freecad（conda-forge）/ 各发行版仓库 / 官网安装包与 AppImage

概述

FreeCAD 核心模块：

支持文件：FCStd、STEP、IGES、BREP、STL、OBJ、PLY、DXF、DWG、SVG、IFC、PDF（导入）、AMF、3MF…

安装

# Linux
sudo apt install freecad
# 或 AppImage：<https://github.com/FreeCAD/FreeCAD/releases>

# macOS
brew install --cask freecad

# Windows：安装包 / Conda
conda install -c conda-forge freecad

FreeCAD 1.x 起合并了大量长期分支（如 PartDesign Toponaming 修复）。当前稳定版 1.1.4（2026-09-28 发布，官方说明这是 1.1.x 系列最后一个维护版本；该版包含两处「打开恶意构造的 FCStd 文件」相关的文件处理安全修复，旧版均受影响，建议升级，参见 FreeCAD Releases）。

核心 API

Python 脚本（FreeCAD 控制台 / 宏）

import FreeCAD as App
import Part

doc = App.newDocument("demo")

# 创建立方体
box = doc.addObject("Part::Box", "MyBox")
box.Length = 100; box.Width = 60; box.Height = 30

# 创建圆柱
cyl = doc.addObject("Part::Cylinder", "MyCyl")
cyl.Radius = 10; cyl.Height = 50
cyl.Placement = App.Placement(App.Vector(50, 30, 0), App.Rotation(0,0,0,1))

# 布尔差集
cut = doc.addObject("Part::Cut", "Cut")
cut.Base = box; cut.Tool = cyl

doc.recompute()
Part.export([cut], "/tmp/out.step")

通过 OCCT/Part 直接构造几何

import Part
from FreeCAD import Vector

# 多边形 → 拉伸
poly = Part.makePolygon([Vector(0,0,0), Vector(50,0,0),
                         Vector(50,30,0), Vector(0,30,0), Vector(0,0,0)])
face = Part.Face(Part.Wire(poly.Edges))
solid = face.extrude(Vector(0, 0, 20))

# 圆角
solid = solid.makeFillet(2, solid.Edges)

Part.show(solid)