本文介绍了什么是资产引用,以及如何在虚幻引擎中查看它们。文中还介绍了用于识别资产引用的虚幻引擎工具,以及相关设置和其他功能。
什么是资产引用?
如果一个资产以某种方式利用另一个资产,那么第一个资产就是在 引用 第二个资产。
例如,如果 立方体Actor 使用 颜色材质 ,该Actor就引用了该材质。也可以说,该Actor存在对该材质的 依赖性 。不妨这样想:该Actor需要该材质,才能获得应有的外观。

在以上示例中,DistanceToNearest_Mat_Gradient 材质引用了 OceanNoise Texture2D资产。
引用是单向的。被引用的资产没有指回其引用者的引用。
引用查看器工具
引用查看器(Reference Viewer) 将显示引用一个或多个资产或者被其引用的资产的图表。
要打开引用查看器,请执行以下操作:
-
在 内容浏览器(Content Browser) 中,选择一个或多个资产。
-
右键点击所选资产。然后,从 上下文菜单 ,选择 引用查看器(Reference Viewer) 。
如果你选择了:
-
一个资产,引用查看器(Reference Viewer) 将显示该资产的引用。
-
多个资产,你只能看到所选资产共有的引用。
-
一个文件夹,你会看到该文件夹中所有资产的引用的图表。
点击查看大图。
上面的截图展示了引用查看器的主要元素。
-
引用所选资产的其他资产。
-
所选资产。
-
所选资产引用的其他资产。
-
引用查看器工具栏。
-
带有多个活动的资产筛选器的搜索面板。
这些元素在下面详细介绍。
资产引用
引用查看器工具将显示引用所选资产或者被其引用的资产的图表。引用关系由指向被引用资产的箭头显示。

在此示例中,三个箭头清楚地指明了 M_Tree_FallTreeMerged_01 材质与其他三个资产之间的关系。
右键点击图表中的资产,打开带有以下选项的上下文菜单:
选项 | 说明 |
---|---|
浏览到资产(Browse to Asset) | 打开 内容浏览器(Content Browser) 窗口,其中选择了资产。 |
编辑(Edit) | 在编辑器中打开资产。例如,世界资产(World Asset) 将在 关卡视口(Level Viewport) 中打开。 |
缩放以适配(Zoom to Fit) | 调整引用树的大小,使其适配窗口。 |
重新居中图表(Re-Center Graph) | 为所选资产生成 新 引用树。 |
建立连接(Make Collection With) | 使用所选资产的引用者或依赖性创建新的 连接 。 |
复制被引用对象列表,复制引用对象列表(Copy Referenced Objects List, Copy Referencing Objects List) | 以文本格式将所选资产的被引用或引用资产列表复制到剪贴板。该列表将使用相对资产路径。 示例: [/Game/Foliage/Foliage_TallGrass - Dependencies] [HARD] /Game/Foliage/M_Lit_Foliage.M_Lit_Foliage |
显示被引用对象列表,显示引用对象列表(Show Referenced Objects List, Show Referencing Objects List) | 以文本格式显示所选资产的被引用或引用资产列表。该列表将使用相对资产路径。 示例: [/Game/Foliage/Foliage_TallGrass - Dependencies] [HARD] /Game/Foliage/M_Lit_Foliage.M_Lit_Foliage |
显示引用树(Show Reference Tree) | 界面上将打开 引用树(Reference Tree) 工具。 引用树将列出特定资产的引用链。引用链是引用列表,其中,列表中的每个对象将引用列表中在其下方的对象。 右键点击引用树中的资产,然后点击 选择Actor(Select Actor) ,在关卡视口中选择该资产的Actor(如果存在)。 要显示引用所选资产的脚本对象,请从引用树菜单启用 选项(Options)> 显示脚本对象(Show Script Objects) 选项。这些引用在默认情况下不显示。 |
大小贴图(Size Map) | 界面上将显示 大小贴图 ,表示资产和依赖性大小(在磁盘上或内存中)的可视明细。这有助于分析性能。 你还可以在内容浏览器中右键点击资产并从内容菜单选择 大小贴图(Size Map) ,打开该资产及其引用的大小贴图。 |
审核资产(Audit Assets) | 打开 资产审核(Asset Audit) 工具,其中显示有关所选资产的详细信息。你可以通过"资产审核(Asset Audit)"窗口右上角的 设置(Settings) 菜单(齿轮图标)将此信息导出到 .csv 文件。 |
引用查看器工具栏
引用查看器工具栏(Reference Viewer toolbar) 位于"引用查看器(Reference Viewer)"窗口顶部,提供了以下选项:

编号 | 名称 | 说明 |
---|---|---|
1 | 刷新(Refresh)、后退(Back) 和 前进(Forward) 按钮 | 这些按钮的行为方式与Web浏览器中的刷新(Refresh)、后退(Back)和前进(Forward)按钮相同。使用它们可刷新视图并找到之前的视图。 |
2 | 查看(View) 菜单 | 包含的选项可用于精细控制引用查看器图表中显示的信息以及该信息的显示方式。 |
3 | 切换重复引用(Toggle Duplicate References) 按钮 | 在可视图表中切换重复引用的显示。 |
4 | 资产筛选器(Asset Filters) 功能按钮 | 资产类型筛选器(Asset Type Filters) 按钮(左侧)将按 搜索面板(Search Panel) 中设置的资产类型筛选器切换引用查看器的筛选(参见下一小节)。 自动填充资产类型筛选器(Auto-Populate Asset Type Filters) 按钮(右侧)将自动选择筛选器,筛选器对应了引用图表中可见的所有资产。该按钮激活时,每次你选择新的根资产或更改图表参数时,搜索面板中的筛选器列表都会自动填充图表中的所有资产类型。 使用 A 键盘快捷键在已筛选和未筛选版本的图表之间切换。 |
5 | 不适用 | 图表中显示其依赖性的资产的相对路径。 |
搜索面板
在引用查看器左上角,使用 搜索(Search) 面板执行以下操作:
- 按名称查找引用或依赖性。
- 按资产类型筛选引用。
- 配置虚幻引擎搜索引用和依赖性的深度。
- 将搜索限制到特定资产集合。

上面的截图展示了搜索面板的主要区域。
编号 | 名称 | 说明 |
---|---|---|
1 | 搜索框 | 按资产名称搜索引用。 |
2 | 筛选器 | 按资产类型筛选引用。这些筛选器的行为方式与内容浏览器中的筛选器相同。 |
3 | 搜索选项 | 使用以下选项进一步配置哪些资产显示在引用查看器图表中: 搜索引用深度(Search References Depth): 引擎搜索引用所选资产的资产的深度。例如,值为2时,图表不仅显示与所选资产相关的资产,还显示与这些相关资产相关的资产。 搜索依赖性深度(Search Dependencies Depth): 引擎搜索依赖性(所选资产引用的资产)的深度。例如,值为2时,图表不仅显示与所选资产相关的资产,还显示与这些相关资产相关的资产。 搜索广度限制(Search Breadth Limit): 给定列中列出的引用数量(引用或被引用)。例如,如果一个资产引用20个资产,但搜索广度限制的值设置为10,则该列中仅显示10个资产。 集合筛选器(Collection Filter): 将搜索限制为单个集合。 |
引用查看器中的资产节点
引用查看器中的每个资产由可视图表中的一个 节点 表示。节点按资产类型进行颜色编码,包含有关资产的更多信息,例如名称、类型、缩略图,等等。
节点可以是正常(完全显示)或紧凑的。通过引用查看器工具栏中的 视图(View) 菜单可在这两种模式之间切换(参见上面的"引用查看器工具栏"小节),或使用 V 键盘快捷键。
![]() |
![]() |
---|---|
正常节点 | 紧凑节点 |
不激活节点
如果你使用筛选器,可能会看到不激活的一些节点(它们是半透明的,总是处于紧凑模式)。你的当前是筛选器将排除这些节点,但它们存在于未排除的两个资产之间。不激活节点仍会显示,以使引用链保持清晰。

在该示例中,材质资产会筛选掉。这两个材质节点(M_Tree_FallBark_01 和 M_Tree_FallTreeMerged_01)仍显示为不激活节点,以使引用链保持完整。
溢出节点
对于搜索面板中较大的 搜索广度限制(Search Breadth Limit) 值,引用查看器不会一次显示所有资产引用。相反,你会看到 溢出(Overflow) 节点。双击该节点可查看剩余引用。

下面的GIF展示了溢出节点的用法。

引用查看器键盘快捷键
函数 | 键盘快捷键 |
---|---|
引用者 | |
增加引用者搜索深度 | R |
减小引用者搜索深度 | SHIFT + R |
设置引用者搜索深度 | CTRL + R |
依赖性 | |
增加依赖性搜索深度 | D |
减小依赖性搜索深度 | SHIFT + D |
设置依赖性搜索深度 | CTRL + D |
广度限制 | |
增加广度限制 | L |
减小广度限制 | SHIFT + L |
设置广度限制 | CTRL + L |
引用类型 | |
显示/隐藏 软 引用 | S |
显示/隐藏 硬 引用 | H |
显示/隐藏 仅限编辑器的 引用 | E |
显示/隐藏 管理 引用 (主资产ID) | M |
显示/隐藏 名称 引用 (可搜索名称) | N |
显示/隐藏 C++ 程序包引用 | C |
视图 | |
显示/隐藏 重复 引用 | U |
切换紧凑 视图 | V |
将资产 路径 切换为注释 | P |
缩放以 适配 | F |
打开/关闭 资产 筛选器 | A |
搜索 | CTRL + F |
[REGION:asset]视图[/REGION] | |
编辑资产 | CTRL + E |
浏览到资产 | CTRL + B |
将所选资产路径复制到剪贴板 | N |