# FreeCAD Python自动化建模实战：从基础几何体到工业级零件设计 在数字化设计领域，参数化建模正逐渐成为工程师和设计师的标配技能。作为开源CAD软件的佼佼者，FreeCAD凭借其Python API的灵活性和易用性，为自动化建模提供了无限可能。本文将带您从零开始，通过五个关键步骤掌握FreeCAD Python脚本建模的核心技术，避开新手常见陷阱，实现从简单几何体到复杂工业零件的自动化创建。 ## 1. 环境配置与基础概念解析 在开始编写第一个FreeCAD Python脚本前，正确的环境配置至关重要。FreeCAD的Python API基于PySide2和OpenCASCADE几何内核构建，这要求我们对软件架构有基本认识。建议从FreeCAD官方网站下载最新稳定版本（当前为1.0+），安装时勾选"Python开发工具"选项。 **关键组件说明**： ```python import FreeCAD, FreeCADGui # 核心模块 import Part # 几何建模模块 from FreeCAD import Vector # 向量运算支持 ``` *注意：FreeCAD内置的Python解释器可能与系统Python环境不同，建议直接在FreeCAD的Python控制台或宏编辑器中编写脚本，避免兼容性问题。* 几何建模的基础是理解点-线-面-体的构建逻辑。在FreeCAD中，所有几何元素都通过Part模块创建： 1. **顶点(Vertex)**：空间中的点，由三维坐标定义 2. **边(Edge)**：连接两个顶点的线段或曲线 3. **线框(Wire)**：由边组成的闭合或不闭合轮廓 4. **面(Face)**：由线框包围的平面或曲面 5. **壳(Shell)**：多个面组成的开放或闭合表面 6. **实体(Solid)**：完全封闭的壳 > 提示：在脚本开头添加`App.newDocument()`可确保每次运行都从干净环境开始，避免对象命名冲突。 ## 2. 基础几何体构建实战 让我们从最简单的长方体开始，逐步构建参数化建模能力。以下代码展示了如何通过定义顶点坐标创建标准长方体： ```python def create_box(length, width, height): doc = App.activeDocument() # 定义8个顶点坐标 vertices = [ Vector(0, 0, 0), Vector(length, 0, 0), Vector(length, width, 0), Vector(0, width, 0), Vector(0, 0, height), Vector(length, 0, height), Vector(length, width, height), Vector(0, width, height) ] # 创建6个面 faces = [ [0,1,2,3], # 底面 [4,5,6,7], # 顶面 [0,1,5,4], # 前面 [1,2,6,5], # 右面 [2,3,7,6], # 后面 [3,0,4,7] # 左面 ] # 构建实体 shell = Part.makeShell([Part.Face(Part.makePolygon([vertices[i] for i in face])) for face in faces]) solid = Part.makeSolid(shell) box = doc.addObject("Part::Feature", "ParametricBox") box.Shape = solid return box # 创建10x5x2的长方体 box = create_box(10, 5, 2) ``` **常见问题排查表**： | 问题现象 | 可能原因 | 解决方案 | |---------|---------|---------| | 模型显示不完整 | 面法线方向错误 | 检查顶点顺序（逆时针） | | 无法生成实体 | 面未闭合 | 使用`Part.checkGeometry()`验证 | | 性能缓慢 | 复杂运算未优化 | 使用`Part.show()`分步调试 | 对于更复杂的三棱柱，我们需要调整顶点和面的定义逻辑： ```python def create_prism(base_vertices, height): doc = App.activeDocument() # 复制底面顶点并沿Z轴偏移 top_vertices = [v + Vector(0,0,height) for v in base_vertices] # 创建侧面 side_faces = [] n = len(base_vertices) for i in range(n): j = (i+1)%n side_faces.append([base_vertices[i], base_vertices[j], top_vertices[j], top_vertices[i]]) # 组合所有面 all_faces = [Part.Face(Part.makePolygon(base_vertices))] # 底面 all_faces.extend([Part.Face(Part.makePolygon(face)) for face in side_faces]) all_faces.append(Part.Face(Part.makePolygon(top_vertices))) # 顶面 # 生成实体 shell = Part.makeShell(all_faces) solid = Part.makeSolid(shell) prism = doc.addObject("Part::Feature", "CustomPrism") prism.Shape = solid return prism # 创建三角形棱柱 triangle = [Vector(0,0,0), Vector(5,0,0), Vector(2.5,4,0)] prism = create_prism(triangle, 3) ``` ## 3. 参数化设计与几何变换 真正的自动化建模核心在于参数化设计。FreeCAD提供了多种几何变换方法，使模型能够根据输入参数动态调整： ```python # 平移变换示例 def translate_shape(shape, displacement): return shape.translate(displacement) # 旋转变换示例 def rotate_shape(shape, axis, angle): return shape.rotate(Vector(0,0,0), axis, angle) # 缩放变换示例 def scale_shape(shape, factor): return shape.scale(factor) # 布尔运算示例 def boolean_union(shape1, shape2): return shape1.fuse(shape2) def boolean_cut(shape1, shape2): return shape1.cut(shape2) ``` **参数化齿轮创建案例**： ```python def create_gear(teeth=12, modulus=1, width=5): doc = App.activeDocument() # 计算齿轮参数 pitch_diameter = teeth * modulus addendum = modulus dedendum = 1.25 * modulus outer_diameter = pitch_diameter + 2 * addendum # 创建基础圆 base_circle = Part.makeCircle(pitch_diameter/2) outer_circle = Part.makeCircle(outer_diameter/2) # 创建齿形轮廓 teeth_profile = [] for i in range(teeth): angle = 2 * math.pi * i / teeth x = outer_diameter/2 * math.cos(angle) y = outer_diameter/2 * math.sin(angle) teeth_profile.append(Vector(x, y, 0)) # 创建齿轮面 wire = Part.makePolygon(teeth_profile + [teeth_profile[0]]) face = Part.Face([Part.Wire(base_circle), Part.Wire(wire)]) # 拉伸成型 gear = face.extrude(Vector(0,0,width)) # 添加中心孔 hole = Part.makeCylinder(pitch_diameter/4, width) final_gear = gear.cut(hole) obj = doc.addObject("Part::Feature", "ParametricGear") obj.Shape = final_gear return obj ``` > 注意：复杂参数化模型建议使用FreeCAD的PartDesign工作台与Spreadsheet结合，实现更直观的参数控制。 ## 4. 工业级零件设计与优化 从基础几何体到工业级零件，需要考虑制造约束和性能优化。以下是一个带加强筋的机械支架设计示例： ```python def create_support_bracket(length=50, width=30, height=20, thickness=3, rib_count=3): doc = App.activeDocument() # 创建基础板 base_plate = Part.makeBox(length, width, thickness) # 创建垂直支撑 vertical_plate = Part.makeBox(thickness, width, height) vertical_plate.translate(Vector(0, 0, thickness)) # 创建加强筋 ribs = [] rib_spacing = length / (rib_count + 1) for i in range(rib_count): x_pos = (i+1) * rib_spacing rib = Part.makePolygon([ Vector(x_pos, 0, thickness), Vector(x_pos, width, thickness), Vector(x_pos, width, height*0.7), Vector(x_pos, 0, height*0.7), Vector(x_pos, 0, thickness) ]) ribs.append(Part.Face(rib)) # 组合所有部件 bracket = base_plate.fuse(vertical_plate) for rib in ribs: bracket = bracket.fuse(rib.extrude(Vector(thickness,0,0))) # 添加安装孔 hole_radius = thickness * 1.5 hole_positions = [ Vector(length*0.2, width*0.2, 0), Vector(length*0.2, width*0.8, 0), Vector(length*0.8, width*0.5, 0) ] for pos in hole_positions: hole = Part.makeCylinder(hole_radius, thickness, pos) bracket = bracket.cut(hole) obj = doc.addObject("Part::Feature", "SupportBracket") obj.Shape = bracket return obj ``` **设计优化技巧**： 1. **壁厚均匀**：确保注塑件壁厚一致，避免缩痕 2. **拔模斜度**：为脱模添加1-3度的斜度 3. **圆角处理**：应力集中区域添加圆角过渡 4. **特征对称**：提高制造效率并减少变形 ## 5. 高级技巧与模型导出 完成模型设计后，正确的导出设置确保模型能在其他软件中正常使用。FreeCAD支持多种工业标准格式： ```python def export_model(obj, filename, format="STEP"): """支持格式：STEP, IGES, STL, OBJ, DXF等""" if format == "STEP": obj.Shape.exportStep(filename) elif format == "STL": obj.Shape.exportStl(filename) elif format == "OBJ": obj.Shape.exportObj(filename) else: raise ValueError("不支持的导出格式") ``` **批量处理与自动化示例**： ```python # 批量生成不同尺寸的零件 sizes = [(10,5,2), (15,8,3), (20,10,4)] for i, (l,w,h) in enumerate(sizes): box = create_box(l, w, h) box.Label = f"Box_{i+1}" export_model(box, f"/output/box_{i+1}.step") # 自动化质量检查 def check_model_quality(shape): """执行基本几何检查""" results = { 'is_closed': shape.isClosed(), 'is_valid': shape.isValid(), 'volume': shape.Volume, 'surface_area': shape.Area } # 检查自相交 analyzer = Part.BRepCheck_Analyzer(shape) results['self_intersects'] = not analyzer.IsValid() return results ``` 在完成所有建模工作后，建议将常用功能封装为自定义工具栏按钮： ```python # 保存为宏并添加到工具栏 macro_code = """ # 示例宏：快速创建标准螺栓 def create_bolt(): # 实现代码... pass create_bolt() """ # 将macro_code保存到FreeCAD的Macro目录 # 通过Tools -> Customize -> Toolbars添加按钮 ``` 掌握这些技术后，您已经能够应对大多数机械设计自动化需求。实际项目中，建议结合FreeCAD的GUI操作与脚本开发，灵活运用各工作台的特性，逐步构建自己的参数化零件库。