1. 项目概述为什么你需要一个“依赖猎人”在Unity项目开发的后期尤其是在临近发布或者进行性能优化、包体瘦身的时候我们经常会遇到一个令人头疼的问题项目文件夹越来越大但里面到底哪些资源是真正被游戏用到的哪些是早已被遗忘在角落的“僵尸资产”手动排查面对成千上万个Prefab、ScriptableObject、材质球和纹理这几乎是一项不可能完成的任务。更糟糕的是如果你不小心删除了一个被间接引用的资产可能会导致游戏在某个意想不到的地方崩溃这种Bug查找起来如同大海捞针。这就是Unity-Dependencies-Hunter依赖猎人诞生的背景。它不是一个新潮的AI工具而是一个纯粹、高效、专注于解决“资产依赖关系”这一核心痛点的实用工具。它的核心功能直截了当扫描你的整个Unity项目找出所有没有任何引用关系的“孤儿”资产并允许你安全地审查和删除它们。对于任何经历过项目臃肿、构建时间漫长、包体超标的开发者来说这无疑是一把锋利的手术刀。我最初接触这个工具是在一个上线多年的手游项目上。项目经过多个团队迭代资产库混乱不堪一个简单的资源更新包热更动辄几百MB玩家下载怨声载道。使用Dependencies-Hunter进行一轮清理后我们直接移除了超过2GB的完全未被引用的纹理、动画和预制体热更包体积瞬间缩减了60%。从那以后它就成了我项目维护工具箱里的常驻工具。简单来说如果你正在为以下问题烦恼那么这个工具就是为你准备的项目构建Build后包体APK/IPA/EXE过大需要瘦身。Unity编辑器运行变慢项目文件夹臃肿影响打开和加载速度。团队协作中资产管理混乱不清楚哪些资源已被废弃。需要进行安全的资源清理但又害怕误删关键资产。2. 核心原理与工作流程拆解在深入解决具体问题之前我们必须理解Dependencies-Hunter是如何工作的。知其然更要知其所以然这能帮助我们在遇到异常结果时快速定位是工具限制还是我们自身的误操作。2.1 依赖分析的底层逻辑工具的核心分析引擎建立在Unity官方提供的AssetDatabaseAPI之上。它的工作流程可以概括为以下几步建立资产地图首先调用AssetDatabase.GetAllAssetPaths()获取项目中所有资产的完整路径列表。这包括了Assets/文件夹下的所有东西脚本、预制体、纹理、材质、场景等但不包括Packages/和ProjectSettings/等特殊目录。构建依赖关系图接着对于上一步得到的每一个资产路径调用AssetDatabase.GetDependencies(path, recursive)。这个API会返回该资产所直接或间接依赖的所有其他资产。例如一个Prefab会依赖其使用的材质材质会依赖其使用的纹理和Shader。通过遍历所有资产工具会构建出一个庞大的“依赖关系有向图”。在这个图中每个资产都是一个节点如果资产A依赖于资产B那么就有一条从A指向B的边。识别“孤儿”节点构建完关系图后工具开始寻找那些“只有入边没有出边”的节点。更准确地说是寻找那些从未出现在任何其他资产的依赖列表里的资产。这些资产就是“未被引用的资产”。它们可能是你早期测试时导入的图片、废弃的脚本、或者某个被删除的Prefab曾经用过的材质球。应用过滤规则最后工具会应用用户设置的忽略规则例如通过正则表达式匹配特定路径并结合可选的“Addressables检测”等高级设置从候选列表中剔除不应被标记为“未使用”的资产最终生成报告。关键理解这个工具检测的是“序列化引用”。也就是说只有在Unity序列化数据中明确记录下来的引用关系例如Prefab中某个GameObject的Material字段指向了一个材质球文件才能被AssetDatabase.GetDependencies捕获到。2.2 高级检测模式解析基础的依赖分析已经很强大了但现代Unity项目尤其是使用了Addressables资源管理系统或涉及特殊系统如地形的项目需要更精细的检测。Dependencies-Hunter提供了几个关键设置来应对这些情况。扫描 Addressables AssetReferences (ScanForAssetReferences)问题在Addressables系统中AssetReference类型的字段是一种特殊的弱引用。Unity默认的AssetDatabase.GetDependencies无法识别这种引用。这意味着一个只被AssetReference引用的宝贵资源会被错误地标记为“未使用”。解决方案开启此选项后工具会改变分析策略。它不再完全依赖AssetDatabase.GetDependencies而是会以文本方式解析资产文件如.prefab, .asset查找AssetReference的GUID。这是一个更慢但更彻底的过程。何时开启只要你的项目中使用了AssetReference字段就必须开启此选项否则清理会导致灾难性后果。检测 Addressables (Detect Addressables)问题通过Addressables系统窗口显式标记为可寻址Addressable的资源其加载是动态的、通过字符串或地址进行的。在编辑器的静态分析视角下它们看起来就是“未被引用”的。解决方案开启此选项后工具会读取项目的Addressables配置数据通常位于Assets/AddressableAssetsData将所有已标记为Addressable的资产从“未使用”列表中排除。何时开启强烈建议在任何使用了Addressables系统的项目中开启。这是保护你动态加载资源的最重要屏障。地形数据引用扫描问题Unity地形Terrain所使用的高度图、细节图等数据其引用关系有时比较隐蔽可能不会被常规依赖分析完全捕获。解决方案这个选项启用后工具会额外执行针对地形数据的专项扫描确保地形资源不被误删。何时开启如果你的项目包含大量或复杂的地形建议开启。对于没有地形的项目可以关闭以提升扫描速度。3. 安装、配置与基础使用指南3.1 两种安装方式及其优劣Dependencies-Hunter提供了两种极简的安装方式体现了其一贯的“开箱即用”哲学。方式一UPMUnity Package Manager安装推荐这是最干净、最便于管理的方式尤其适合团队协作。在Unity编辑器中打开Window Package Manager。点击左上角的“”按钮选择“Add package from git URL...”。在弹出的输入框中粘贴仓库地址https://github.com/AlexeyPerov/Unity-Dependencies-Hunter.git。点击Add。Unity会自动下载并导入该包。优势版本清晰可通过Package Manager更新不会污染你的Assets目录易于从项目中移除。劣势需要网络连接。方式二直接复制脚本文件如果你处于离线环境或者希望工具完全成为项目的一部分可以采用此方式。访问项目的GitHub页面找到根目录下的DependenciesHunter.cs文件。点击打开该文件复制其全部内容。在你的Unity项目的Assets目录下或任何其子目录但建议是Assets/Editor或Assets/Plugins/Editor创建一个新的C#脚本例如命名为DependenciesHunter.cs。用刚才复制的内容完全替换新脚本文件中的默认代码。优势完全离线脚本成为项目资产的一部分。劣势更新麻烦需要手动替换如果放在非Editor文件夹可能导致编译错误。实操心得对于长期项目我强烈推荐使用UPM方式。它不仅管理方便更重要的是当工具作者发布新版本修复Bug或增加功能时你只需要在Package Manager里点击更新即可避免了手动替换可能带来的错误或遗漏。3.2 首次运行与界面详解安装完成后你可以在Unity编辑器顶部菜单栏找到它Tools Dependencies Hunter。点击后会打开主窗口。主窗口界面主要分为以下几个区域控制区顶部Analyze Project按钮开始扫描整个项目。Analysis Settings折叠菜单用于配置扫描参数后文详述。Refresh按钮在已有扫描结果的基础上重新分析速度较快。结果列表区中部扫描完成后这里会以列表形式展示所有资产。默认只显示“未引用的资产”。每一列代表资产路径、类型、大小、引用计数等。操作区底部Show Unreferenced Assets Only复选框勾选时只显示零引用的资产取消勾选则显示项目所有资产及其引用数。这是排查问题的关键视图。Delete Selected按钮删除在列表区选中的资产。慎用Select All/Deselect All按钮快速全选或取消全选。Export to CSV按钮将当前列表导出为CSV文件便于用Excel进行进一步分析或存档。3.3 分析设置Analysis Settings深度配置点击Analysis Settings展开折叠菜单这里是工具的核心控制台。Ignore Patterns (RegEx) 这是最重要的安全阀之一。你可以通过正则表达式来排除特定路径或类型的资产。例如.*\.cs$忽略所有C#脚本文件。脚本通常通过编译成DLL被引用静态分析很难追踪且删除脚本是危险的。.*/Editor/.*忽略所有Editor文件夹下的内容。这些是编辑器工具资产本来就不会被打包。.*/Resources/.*谨慎使用Resources文件夹下的资源是动态加载的也可能被误判。但如果你确定某些Resources资源是废弃的可以不忽略。MySpecialFolder/.*忽略你自定义的某个文件夹。你可以点击输入框下方的“Create default ignore patterns asset”来创建一个DependenciesHunterIgnorePatterns.asset文件。这个文件会保存在Assets/Editor下里面包含了工具内置的默认忽略规则如.cs,.asmdef等。你可以直接编辑这个Asset文件来永久修改忽略规则这比每次在窗口里输入要方便可靠得多。Scan for AssetReferences 如前所述如果你使用了Addressables的AssetReference必须勾选。注意勾选后扫描时间会显著增加因为它要从文本层面解析资产。Detect Addressables 如果你使用了Addressables系统必须勾选。这是防止误删动态加载资源的保险丝。Scan terrain data references 按需开启。对于有地形的项目建议开启。4. 实战全流程从扫描到安全清理理论配置完毕我们进入实战环节。一次完整、安全的资源清理应该遵循严格的步骤。4.1 第一步完整扫描与结果解读备份备份备份在进行任何删除操作前请确保你的项目已使用Git、SVN或任何版本控制系统提交了最新更改或者手动复制了整个项目文件夹。这是铁律。打开Dependencies Hunter窗口。在Analysis Settings中根据你的项目情况正确配置Scan for AssetReferences和Detect Addressables。点击Analyze Project。扫描时间取决于项目大小可能从几十秒到几十分钟不等。一个超过20GB资产的项目首次扫描可能需要较长时间。扫描完成后列表会显示所有“未引用的资产”。但请不要立刻相信这个列表。4.2 第二步关键验证与排查“假阳性”工具的结果是“未找到引用”但不等于“绝对没用”。我们需要手动验证排除“假阳性”情况。这是最需要经验和耐心的环节。取消勾选 “Show Unreferenced Assets Only”。现在列表显示了所有资产及其“引用计数”。我们需要重点关注那些引用计数为0但又可能被用到的资产类型Resources 文件夹下的资产现象Assets/Resources/MyIcon.png引用计数为0。原因Resources.Load()是通过字符串路径动态加载的静态分析无法捕获。验证在项目中全局搜索“MyIcon”或“Resources.Load”检查是否有代码加载它。如果找不到再结合项目逻辑判断是否可删。AssetBundle 或 Addressables 资源未正确标记现象一个纹理或预制体引用计数为0但你记得它被打包进了某个AssetBundle或应该被Addressables管理。原因可能漏掉了Addressables标记或者AssetBundle的构建是通过脚本动态指定的而非通过AssetImporter的assetBundleName属性。验证检查Addressables Groups窗口或者搜索设置assetBundleName的代码。通过字符串路径动态加载的资产现象Resources.Load(“Path/To/Asset”)或AssetDatabase.LoadAssetAtPath。验证在代码中搜索资产文件名或路径关键字。Shader、ComputeShader等图形资源现象一个自定义Shader或ComputeShader文件引用计数为0。原因它们可能在运行时由Material或Graphics API使用但序列化引用可能不直观。验证搜索哪些Material使用了这个Shader。或者如果它是项目核心渲染管线的一部分即使暂时未被引用也应保留。ScriptableObject 数据资产现象一个.asset文件引用计数为0。原因可能被代码通过Resources.Load或地址化方式加载。验证搜索该资产类型或文件名。排查技巧对于不确定的资产一个安全的方法是先移动后删除。在Project窗口中创建一个临时文件夹如_ToDelete将可疑资产拖进去。然后运行游戏彻底测试所有功能。如果一切正常过一两个开发周期后再删除这个临时文件夹。4.3 第三步执行删除与善后选择性勾选在结果列表中仔细勾选你经过验证后确认可以删除的资产。对于纹理、音频等大文件可以按大小排序优先处理“大块头”。执行删除点击Delete Selected。工具会弹出一个确认对话框再次提醒你操作不可逆。处理删除结果删除完成后Unity编辑器可能需要一些时间来刷新数据库。你可能会在Console窗口看到一些 Missing Reference 的警告黄色。这是正常的因为这些警告指向的资产已经被删除了。验证项目立即进行一次完整的项目构建Build并运行测试确保游戏功能正常。这是最终的质量关卡。清理空文件夹资产删除后可能会留下大量空文件夹。Dependencies-Hunter不负责这个。你可以使用其他编辑器插件如“Remove Empty Directories”或手动清理以保持项目结构整洁。5. 高级技巧与场景化应用掌握了基础操作我们来看看如何在不同场景下更高效、更精准地使用这个工具。5.1 针对特定文件夹或资产类型进行扫描有时你不需要扫描整个项目只想分析某个特定的功能模块或资源类型。方法利用Ignore Patterns的反向思维。你可以先设置一个非常宽泛的忽略规则如.*忽略一切然后再添加特例。但更简单的方法是取消勾选Show Unreferenced Assets Only扫描全部资产。在结果列表的搜索框中输入路径关键词如Assets/Art/Characters进行过滤。手动检查过滤后列表中引用计数为0的资产。虽然不如自动分析方便但对于定向排查非常有效。5.2 与版本控制系统Git协同工作Dependencies-Hunter是代码仓库“瘦身”的神器。流程在准备进行一次大版本提交或发布前运行一次全面的依赖分析和清理。好处减少仓库体积删除的资产将从Git历史中移除在下次GC后加快克隆和拉取速度。提升协作清晰度新加入的开发者不会接触到一堆废弃资源减少困惑。注意确保团队所有成员都在清理操作之后获取最新的仓库状态否则他们本地的废弃资产可能会引起冲突。5.3 排查“幽灵引用”与依赖循环当你发现一个你认为应该被引用的资产却出现在未引用列表中时可能是遇到了“引用断裂”或工具检测盲区。使用“查找引用”功能在Project窗口中右键点击任何一个资产在上下文菜单中选择“[DH] Find References in Project”。这会打开一个新窗口列出所有引用该资产的上级资产。这是一个逆向排查的神器。场景材质球A显示未引用。你右键对它使用此功能发现它被Prefab B引用。但Prefab B本身也是未引用状态。这就形成了一个“引用链”你需要找到这个链的顶端——那个被场景或代码引用的根资产。如果“查找引用”返回空那说明在Unity的序列化世界里确实没有任何资产记录了对它的引用。你需要按4.2节的方法排查动态加载的可能性。5.4 作为持续集成CI流程的一部分对于大型团队可以将资源检查自动化。思路编写一个编辑器脚本在CI服务器上以批处理模式-batchmode -quit调用Dependencies-Hunter的扫描功能。动作脚本可以导出未引用资产列表CSV并与上一次的结果进行对比。如果发现了新增的、较大的未引用资产CI可以发出警告提醒开发者检查是否误提交了无用资源。注意自动删除在CI中风险极高通常只做检查和报告。6. 常见问题排查与解决方案实录即使工具本身很可靠在实际使用中还是会遇到各种奇怪的问题。下面是我和同事们踩过的一些坑以及解决办法。6.1 扫描过程卡住或异常缓慢问题现象点击Analyze后进度条几乎不动或者Unity编辑器无响应。可能原因与解决项目资产极多首次扫描需要建立完整的依赖图耐心等待。可以观察编辑器日志看是否有错误输出。开启了Scan for AssetReferences此选项会进行文本解析速度慢一个数量级。如果项目很大首次扫描请做好长时间等待的准备。后续的Refresh操作会快很多。存在损坏的资产某个资产文件损坏导致AssetDatabase.GetDependencies调用时卡死。尝试在扫描前在Console窗口中清除所有错误并尝试修复或删除明显的错误资产如图片导入设置错误。磁盘I/O或杀毒软件确保项目在SSD上并暂时关闭实时扫描项目的杀毒软件。6.2 工具报告“未引用”但游戏运行时需要该资产问题现象清理后游戏在某个界面或场景崩溃提示缺少资源。根本原因动态加载的引用未被工具识别。排查步骤确认设置检查是否开启了Detect Addressables和Scan for AssetReferences如果适用。搜索代码在崩溃的模块相关代码中全局搜索该资产的文件名、路径片段或资源名。重点搜索Resources.Load,AssetBundle.LoadAsset,Addressables.LoadAssetAsync等API。检查AssetBundle如果使用旧版AssetBundle检查资产的assetBundleName属性是否设置。工具只能识别通过此属性明确标记的依赖。检查ScriptableObject或配置表资产可能被一个ScriptableObject数据文件引用而这个数据文件本身又是被代码动态加载的。需要逐级向上查找引用链。6.3 删除资产后编辑器出现大量Missing脚本或粉红材质警告问题现象删除后场景或预制体上出现大量黄色警告Missing Script或粉红色材质。原因你删除的资产被其他资产所引用。工具的判断是基于最后一次扫描的快照。如果在扫描之后、删除之前你或其他团队成员新增了对这些资产的引用那么工具是不知道的。解决方案立即撤销如果刚删除立即使用CtrlZ(Windows) /CmdZ(Mac) 撤销操作。从版本控制恢复如果已无法撤销从Git等版本控制中恢复被删除的文件。重新关联如果无法恢复只能手动寻找备份或使用类似的资产重新进行关联设置。这是一个惨痛的教训强调了验证和备份的重要性。预防在点击删除按钮前确保项目处于“干净”状态没有未保存的更改或刚刚建立的引用。6.4 忽略模式Ignore Patterns不生效问题现象我已经添加了.*\.cs$规则但C#脚本仍然出现在未引用列表中。可能原因正则表达式错误确保你的正则表达式语法正确。.*\.cs$表示“以.cs结尾的任何字符串”。在线正则表达式测试工具可以帮助你验证。使用了自定义设置文件如果你创建了DependenciesHunterIgnorePatterns.asset文件那么窗口中的输入框将不再起作用工具会优先读取Asset文件中的规则。你需要去编辑这个.asset文件。规则冲突可能存在多条规则某条更具体的规则覆盖了你的忽略规则。检查规则列表的顺序在.asset文件中更直观。6.5 如何安全地清理“看似被用”的共享资源这是一个高阶问题。例如一个材质球Mat_A被10个预制体引用但这10个预制体全都是未引用的。从依赖图上看Mat_A的引用计数是10所以工具不会标记它。但实际上它和那10个预制体应该作为一个“垃圾岛屿”被整体清理。手动排查利用“查找引用”功能对Mat_A使用找到那10个预制体。然后逐一检查这10个预制体是否真的未被使用。策略这种情况下你需要先删除或处理掉那些根部的未引用预制体。删除它们后Mat_A的引用计数会下降。当所有引用它的预制体都被删除后Mat_A在下次扫描中自然就会出现在未引用列表里。清理依赖资源时应从引用链的末端根资产向始端基础资源推进。最后我个人最深刻的一个体会是Dependencies-Hunter给出的不是一个“删除清单”而是一份“审计报告”。它的价值不仅仅是找出可以删除的文件更是强迫你去审视项目的资产结构理解资源之间的引用关系。每一次使用它都是一次对项目架构的重新认识。养成定期比如每个里程碑版本运行检查的习惯远比等到项目臃肿不堪时再做“大手术”要健康得多。在点击“Delete Selected”之前的那份谨慎和验证是区分新手和老手的关键。