在3D创作过程中，重复性操作占据了大量时间。 Blender 内置的Python API提供了强大的脚本编程能力，可以将繁琐的手动操作转化为自动执行的代码。本文将从零开始讲解Blender Python脚本的基础知识，帮助你掌握参数化建模和批量生成的核心技巧，大幅提升建模效率。
Blender Python API基础架构
Blender的Python API基于bpy模块，整个API分为三个核心子模块：bpy.data（数据访问）、bpy.context（上下文信息）和bpy.ops（操作调用）。bpy.data用于访问场景中的所有数据块，包括网格、材质、纹理等；bpy.context提供当前操作的上下文环境；bpy.ops则模拟用户在Blender界面中的操作。
编写脚本的第一步是打开Blender的Scripting工作区，在文本编辑器中新建脚本。最简单的入门代码是导入bpy模块后创建基本物体：import bpy; bpy.ops.mesh.primitive_cube_add(size=2, location=(0,0,0))。这行代码会在坐标原点创建一个边长为2的立方体。
建议新手从以下几个基础操作开始练习：创建和删除物体、切换物体模式和编辑模式、选择和解选顶点/边/面。Blender还提供了Python Console控制台，可以逐行测试代码并立即看到效果，是学习和调试脚本的理想环境。
对象创建与属性控制
除了基本图元创建，Python脚本还可以精确控制物体的所有属性。创建立方体后，可以通过bpy.context.object获取当前活动对象，然后修改其位置（location）、旋转（rotation_euler）和缩放（scale）属性。对于网格对象，还可以直接操作vertices、edges和faces数据。
参数化建模的核心在于使用变量控制几何参数。例如，创建一个函数generate_gear(teeth, radius, height)，函数内部使用数学计算生成齿轮的顶点坐标，然后通过bpy.data.meshes.new创建网格，再用from_pydata方法填充顶点、边和面数据。这种方法可以快速生成传统手动建模难以完成的参数化结构。
材质和修改器的添加同样可以通过脚本完成。使用bpy.data.materials.new创建材质，设置其节点树属性，然后赋值给物体。修改器的添加使用obj.modifiers.new方法，例如obj.modifiers.new(name="Bevel", type='BEVEL')，然后设置segment和width参数。将整个流程封装成函数后，只需调整入口参数即可生成不同规格的模型。
批量生成与场景管理
批量生成是脚本建模的最大优势之一。通过for循环，可以在几秒钟内生成成百上千个物体。例如，用于生成建筑群落的脚本：循环遍历网格坐标，在每个位置随机生成长方体，并随机分配高度和旋转角度。配合random模块可以创建自然的随机分布效果，适用于植被散布、城市布局等场景。
场景管理同样离不开脚本。对于大型项目，使用bpy.data.objects清除不需要的物体，使用bpy.ops.object.select_all(action='SELECT')和bpy.ops.object.delete()批量移除。集合管理使用bpy.data.collections.new创建集合，通过collection.objects.link将物体分配到指定集合，保持场景结构的清晰有序。
在批量生成的性能优化方面，建议使用以下技巧：在循环外调用bpy.context.view_layer.update()而不是每次迭代都更新；使用bpy.ops.object.select_all(action='DESELECT')避免自动选择新增物体造成的性能开销；对于不需要独立编辑的大量物体，使用实例化（Instancing）而非独立创建，可以显著降低内存占用。
实用脚本案例与调试技巧
下面提供一个实用的参数化螺旋楼梯生成脚本框架：通过定义半径、阶数、高度、旋转角度等参数，使用数学公式计算每阶台阶的位置和旋转角度，在循环中逐阶创建。整个脚本不超过50行，却可以生成任意规格的螺旋楼梯，精度和一致性远超手动建模。
脚本调试是学习过程中的重要环节。Blender的Info编辑器会显示所有bpy.ops操作的日志，帮助理解操作对应的API调用。使用print()函数输出中间变量值，在Python Console中查看输出结果。遇到错误时，仔细阅读错误信息中的文件路径和行号，定位问题代码。常见错误包括：属性名拼写错误、对象引用失效、模式未正确切换等。
建议将常用的建模脚本保存为.py文件，通过Blender的文本编辑器加载使用。也可以将脚本注册为插件（Add-on），创建自定义面板和操作按钮，形成个人的建模工具箱。掌握了Blender Python脚本编程，你就从一个手动建模师升级为具备程序化思维的高级创作者，能够用代码大幅扩展3D创作的可能性边界。