在blender中通过脚本导入.blend文件内容的核心方法是使用bpy.ops.wm.append或bpy.ops.wm.link操作符，前者将数据完全复制到当前文件实现独立修改，后者创建对源文件数据的引用以实现共享与同步更新，适用于不同工作流需求；通过指定源文件路径、数据类型（如object、collection、material等）和具体名称，结合os.path.join构建正确路径并处理常见路径、命名与权限问题，可实现模型、材质、动画等多种数据类型的自动化导入，提升项目效率与资产管理能力。
在Blender里，如果你想通过脚本把一个
.blend登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制文件里的内容（比如模型、材质、动画）导入到当前场景，核心操作就是利用Blender的Python API中的
bpy.ops.wm.append登录后复制登录后复制登录后复制或
bpy.ops.wm.link登录后复制登录后复制登录后复制功能。它们能让你以编程方式实现通常在UI里手动进行的“追加”或“链接”操作，非常适合自动化工作流程，尤其是在需要批量处理或者构建动态场景的时候，简直是效率提升的利器。
解决方案
要通过脚本导入
.blend登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制文件中的内容，我们主要依赖
bpy.ops.wm.append登录后复制登录后复制登录后复制或
bpy.ops.wm.link登录后复制登录后复制登录后复制这两个操作符。它们的使用方式非常相似，关键在于指定源文件的路径、要导入的数据类型（比如“Object”、“Collection”等），以及具体的数据名称。
以下是一个导入特定对象（比如一个名为“MyCube”的立方体）的脚本示例
import bpyimport os# 1. 定义源.blend文件的完整路径# 务必替换成你实际文件的路径！例如C:/Users/YourUser/documents/my_assets.blendsource_blend_filepath = "D:/Blender_Assets/my_models.blend"# 2. 定义你想要导入的数据类型# 常见的有 "Object", "Collection", "Material", "Scene", "Action", "NodeTree" (用于几何节点或着色器)data_type = "Object"# 3. 定义你想要导入的具体数据项的名称# 例如，如果data_type是"Object"，这里就是对象的名称；如果是"Collection"，就是集合的名称。item_name = "Cube.001" # 假设你的my_models.blend文件里有一个名为"Cube.001"的对象# 4. 构建导入操作所需的目录路径# 这个路径不是文件系统的目录，而是Blender内部.blend文件结构中的目录。# 比如，要导入对象，就是源文件路径加上"//Object/"directory_path = os.path.join(source_blend_filepath, data_type) + os.sep# 5. 执行导入操作 - 使用 append# append 会将数据完全复制到当前文件中，成为独立的数据块。try: bpy.ops.wm.append( filepath=os.path.join(directory_path, item_name), # 完整的文件内路径 directory=directory_path, # 数据类型目录 filename=item_name, # 要导入的数据项名称 set_active=True, # 导入后是否设置为活动对象 do_update=True # 是否更新场景 ) print(f"成功追加导入 '{item_name}' 从 '{source_blend_filepath}'")except RuntimeError as e: print(f"导入 '{item_name}' 失败: {e}") print("请检查源文件路径、数据类型和数据项名称是否正确，以及源文件是否存在。")# 如果你需要导入一个集合（Collection），并且想使用 link（链接）的方式# link 会创建对源文件中数据的引用，源文件改变，当前文件中的链接数据也会随之改变。# data_type_link = "Collection"# item_name_link = "MyAssetCollection" # 假设源文件有一个名为 "MyAssetCollection" 的集合# directory_path_link = os.path.join(source_blend_filepath, data_type_link) + os.sep# try:# bpy.ops.wm.link(#filepath=os.path.join(directory_path_link, item_name_link),#directory=directory_path_link,#filename=item_name_link,#set_active=True,#do_update=True# )# print(f"成功链接导入 '{item_name_link}' 从 '{source_blend_filepath}'")# except RuntimeError as e:# print(f"链接 '{item_name_link}' 失败: {e}")print("\n脚本执行完毕。")登录后复制Blender脚本中 append
登录后复制登录后复制登录后复制登录后复制 和 link
登录后复制登录后复制登录后复制登录后复制 有什么区别？什么时候用哪个？
这俩兄弟看着像，骨子里可不一样。理解它们的核心差异，是高效管理Blender项目资产的关键。
append登录后复制登录后复制登录后复制登录后复制（追加）操作，顾名思义，就是把源
.blend登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制文件中的数据完整复制一份到你当前的工作文件中。这意味着，一旦数据被追加进来，它就成了当前文件的一部分，与源文件再无瓜葛。你可以在当前文件中随意修改这些追加进来的数据，而不会影响到源文件，反之亦然。它的优点是独立性强，便于本地化修改；缺点是可能会增加当前文件的大小，而且如果源文件更新了，你需要手动重新追加才能获取最新版本。
link登录后复制登录后复制登录后复制登录后复制（链接）操作则完全不同。它不会复制数据，而是在当前文件中创建一个对源文件中数据的引用。你可以把它想象成一个快捷方式或者一个实时视图。这意味着，如果你修改了源文件中的数据，当前文件中所有链接到该数据的实例都会立即同步更新。这对于团队协作、构建共享资产库或者管理大型项目非常有用，因为它可以显著减小文件大小，并确保所有使用相同资产的项目都能保持同步。但它的缺点也很明显你不能直接在当前文件中对链接的数据进行大幅修改（除非通过“Library Override”机制，那又是另一个话题了），而且如果源文件被移动、重命名或删除，链接就会失效。
什么时候用哪个？
使用 link
登录后复制登录后复制登录后复制登录后复制 的场景
简而言之，
append登录后复制登录后复制登录后复制登录后复制 追求独立和本地化控制，
link登录后复制登录后复制登录后复制登录后复制 追求共享和同步更新。选择哪一个，取决于你的项目需求和工作流程。
编写导入脚本时，路径和文件名有哪些常见的坑？
路径问题简直是编程界的老大难，Blender脚本里也一样，一不小心就掉坑里。
绝对路径与相对路径的混淆
directory
登录后复制登录后复制登录后复制登录后复制 参数的误解
文件名/数据项名称的拼写与大小写
源文件或数据项不存在
权限问题
这些坑其实都是细节问题，但往往最容易被忽视。写脚本的时候多一点细心，多利用
os.path登录后复制模块，并做好错误处理，就能省下大量的调试时间。
除了导入模型，还能用脚本导入哪些数据类型？
Blender的
.blend登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制文件就像个百宝箱，里面装的可不只是模型。通过脚本，我们几乎可以导入任何Blender支持的数据块类型，这为自动化工作流提供了极大的灵活性和强大的资产管理能力。
除了最常见的
Object登录后复制（对象，通常指模型），你还可以导入以下常见的数据类型
Collection登录后复制 (集合): 这是非常推荐的导入方式。一个集合可以包含多个对象、灯光、摄像机，甚至其他集合。通过导入集合，你可以一次性将一组相关的资产带入当前场景，并且它们在集合层级上保持组织性。这对于构建模块化的场景或资产库非常有用。
Material登录后复制 (材质): 如果你有一个材质库文件，可以单独导入特定的材质，然后将其应用到当前场景的模型上。这对于保持材质风格统一、快速着色非常方便。
Scene登录后复制 (场景): 你可以导入另一个
.blend登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制文件中的整个场景。这会把源场景中的所有对象、灯光、摄像机、集合、世界设置等都带入当前文件，但它们会作为独立的一个“场景”数据块存在，你可以通过场景选择器切换。
Action登录后复制 (动作/动画): 导入特定的动画数据块（比如一个角色的行走循环动画），然后将其应用到当前场景中的骨架（Armature）上。这对于动画师来说是极大的便利，可以复用动画库。
NodeTree登录后复制 (节点树): 这包括了多种节点组
World登录后复制 (世界): 导入另一个文件中的世界设置，包括环境光、背景颜色或HDRI环境贴图设置。这有助于快速统一场景的整体照明和氛围。
Light登录后复制 (灯光): 导入特定的灯光设置，比如一个预设的区域光或聚光灯。
Camera登录后复制 (摄像机): 导入一个预设的摄像机视角和设置。
Armature登录后复制 (骨架): 导入独立的骨架数据，用于绑定模型。
Mesh登录后复制 (网格): 如果你只想导入纯粹的几何数据，而不是带有修饰器或位置信息的对象，可以直接导入网格数据块。
Curve登录后复制 (曲线): 导入曲线数据，用于路径动画、建模等。
GreasePencil登录后复制 (蜡笔): 导入蜡笔数据，用于2D动画或注释。
Image登录后复制 (图像): 导入图像数据块，通常用于材质纹理或背景图像。
要导入这些不同类型的数据，你只需要在脚本中修改
data_type登录后复制 变量为对应的字符串（例如
data_type = "Collection"登录后复制），并确保
item_name登录后复制登录后复制登录后复制 变量是该类型数据块的正确名称即可。这种灵活性使得Blender的脚本导入功能成为了构建强大、可复用资产管道的核心工具。