1. 项目概述：为什么我们需要Addressables？

如果你在Unity项目里做过资源加载，大概率经历过Resources文件夹的“甜蜜与烦恼”。早期项目小，用Resources.Load确实方便，但随着资源膨胀，你会发现打包后那个巨大的resources.assets文件，以及“改个贴图就得全量更新”的噩梦。AssetBundle是更专业的方案，但它上手门槛高，依赖管理、打包流程、热更新策略都得自己从头搭建，一个环节没处理好，线上可能就是一片红。

Addressables（可寻址资源系统）就是Unity官方给出的“一站式”解决方案。它本质上是对AssetBundle的封装和增强，但提供了更高级的抽象。你可以把它理解为一个“智能的资源管家”。你不再需要直接操心AssetBundle的打包、加载和卸载细节，而是通过给每个资源分配一个唯一的“地址”（Address），像在网盘里通过链接访问文件一样，通过这个地址来异步加载资源。这个管家会自动帮你处理依赖、缓存、内存管理，甚至无缝对接本地和远程资源。

这次，我们不谈空洞的理论，直接从一个干净的Unity项目开始，手把手完成Addressables系统的安装、基础配置，并实现最核心的“本地加载”功能。这是你驾驭这套强大系统的第一步，也是最坚实的一步。

2. 环境准备与核心概念扫盲

2.1 安装Addressables Package

安装过程本身很简单，但有几个关键选择点决定了后续的工作流。

步骤与选型理由：

1. 打开Package Manager：在Unity编辑器中，点击顶部菜单Window > Package Manager。
2. 切换视图：在Package Manager窗口左上角，确保视图从“In Project”切换到“Unity Registry”。这样才能看到Unity官方维护的所有可用包。
3. 搜索与安装：在搜索框中输入“Addressables”。在列表中找到它，点击右侧的“Install”按钮。这里你会看到版本号，建议安装官方推荐的、标记为“Verified”的稳定版本（例如1.19.19或更新版本），避免使用尚在预览（Preview）状态的版本，以减少未知风险。

注意：安装完成后，Unity编辑器可能会短暂卡顿并重新编译脚本，这是正常现象。你会在顶部菜单栏看到新增的Window > Asset Management > Addressables选项，说明安装成功。

核心概念建立：

在动手前，先快速理解三个贯穿始终的核心对象，这能让你后面的操作不再是“黑盒”：

• Address（地址）：你给资源起的“名字”或“路径”，是加载资源的唯一标识符。比如"Assets/Arts/Characters/Hero.prefab"或一个更友好的"Hero_Prefab"。
• Group（资源组）：逻辑上的资源容器，用于决定如何打包。你可以按类型（如所有UI贴图）、按场景（如“主城场景”）、按更新频率（如“基础包”、“活动包”）来划分组。一个Group在打包后通常对应一个或多个AssetBundle文件。
• Profile（配置方案）：定义了资源加载路径的配置集合。比如，开发时从本地项目加载，测试时从本地模拟服务器加载，上线后从CDN加载。通过切换Profile，可以快速改变整个项目的资源来源，无需修改代码。

2.2 初始化Addressables系统

安装完包只是拥有了工具，我们需要初始化并创建必要的数据结构。

1. 打开Addressables窗口：点击Window > Asset Management > Addressables > Groups。
2. 初始化：如果你是第一次使用，窗口会提示“Addressables data has not been initialized for this project.”。点击Create Addressables Settings按钮。
   • 这个操作做了什么？它会在你项目的Assets/AddressableAssetsData目录下，创建一系列核心配置文件和一个默认的Default Local Group（资源组）。这个目录就是Addressables系统的“大脑”，所有配置、构建结果和运行时数据都关联于此。
3. 检查生成结构：在Project窗口，定位到Assets/AddressableAssetsData文件夹。你会看到至少包含以下文件：
   • AddressableAssetSettings.asset: 全局设置文件，记录了所有Group、Profile、构建路径等核心配置。
   • AssetGroups: 文件夹，里面存放着每个Group的配置数据。初始会有一个Default Local Group.asset。

3. 资源标记与管理：将你的资产交给管家

现在，我们开始把项目里的资源（Prefab、材质、音效等）标记为可寻址资源。

3.1 标记资源的三种方式

Addressables提供了非常灵活的资源标记方式，适应不同场景。

方式一：在Inspector面板手动标记（最直观）

1. 在Project窗口选中一个资源，例如一个Prefab。
2. 在Inspector面板，你会看到“Addressable”复选框，勾选它。
3. 下方会出现更多选项：
   • Address：自动生成，通常是资源在项目中的路径。强烈建议你修改为一个简短、有意义的唯一标识符，如PlayerShip。代码里加载时就用这个字符串。
   • Labels：标签。可以为资源打上多个标签（如UI,HighPriority），实现批量加载或分类管理。
   • Include in Build：是否包含在构建中。对于始终随包发布的资源（如游戏启动必需的资源），勾选。对于需要热更新的资源，通常不勾选，后续单独构建和上传。

方式二：通过Addressables Groups窗口拖拽

1. 保持Addressables Groups窗口打开。
2. 直接从Project窗口将资源拖拽到窗口内的某个Group（例如Default Local Group）中。
3. 资源会自动被标记为Addressable，并且归属到这个Group。你可以在窗口内直接编辑它的Address和Labels。

方式三：通过脚本批量标记（适合大量资源）对于有成百上千个资源需要处理的情况，手动操作是灾难。Addressables提供了API供你在编辑器脚本中批量操作。

using UnityEditor; using UnityEditor.AddressableAssets; using UnityEditor.AddressableAssets.Settings; public class AddressableBatchProcessor { [MenuItem("Tools/Batch Mark Sprites as Addressable")] static void BatchMarkSprites() { // 获取Addressables设置对象 var settings = AddressableAssetSettingsDefaultObject.Settings; // 获取或创建目标Group var group = settings.FindGroup("UI Sprites Group") ?? settings.CreateGroup("UI Sprites Group", false, false, false, null); // 搜索所有指定路径下的Sprite string[] guids = AssetDatabase.FindAssets("t:Sprite", new[] {"Assets/Arts/UI"}); foreach (var guid in guids) { string path = AssetDatabase.GUIDToAssetPath(guid); // 将资源添加到Addressables系统中，并指定Group和Address（这里用文件名） var entry = settings.CreateOrMoveEntry(guid, group); entry.address = System.IO.Path.GetFileNameWithoutExtension(path); } AssetDatabase.SaveAssets(); } }

实操心得：Address命名规范早期随意命名，后期维护会非常痛苦。建议建立团队规范，例如：

• Prefab/Characters/HeroWarrior
• Audio/SFX/UI_Click
• Scene/Level_01避免使用空格和特殊字符，使用下划线或驼峰命名。清晰的地址是高效加载和团队协作的基础。

3.2 创建与管理资源组（Groups）

默认的Default Local Group适合放一些零散资源，但规范的项目必须按逻辑划分Group。

1. 创建新Group：在Addressables Groups窗口，点击左上角的Create按钮，选择Create Group。你会看到几种类型：
   • Packed Assets：最常用的类型，组内资源会被打包到一起。
   • Shared Packed Assets：用于存放被多个其他组依赖的公共资源（如通用材质、Shader），避免重复打包。
2. Group的关键设置：选中一个Group，在Inspector面板有大量配置：
   • Build & Load Paths：决定这个组打包后文件的输出位置（Build Path），以及运行时从何处加载（Load Path）。我们首次实践使用内置的LocalBuildPath和LocalLoadPath即可，它们指向项目内的Library/com.unity.addressables目录。
   • Bundle Mode：
     • Pack Together：组内所有资源打成一个Bundle。（适合关联紧密的资源）
     • Pack Separately：每个资源单独打成一个Bundle。（适合需要独立更新的资源，但文件数量多）
     • Pack Together By Label：按标签分包。
   • Advanced Options：如压缩格式（LZMA, LZ4），LZ4压缩率低但加载快，适合本地；LZMA压缩率高但需要解压，适合网络下载。

一个常见的分组策略示例：

• BuiltIn_Scenes: 包含初始场景，随包发布。
• BuiltIn_UI: 包含游戏主界面、通用弹窗等核心UI。
• Dynamic_Characters: 包含英雄、怪物Prefab和动画，可热更新。
• Shared_Common: 包含通用材质、ShaderVariantCollection，被多个组依赖。

4. 构建（Build）资源：生成可加载的数据包

标记好资源并分组后，下一步是“构建”（Build）。这个过程相当于传统AssetBundle的“打包”，它会根据你的配置，生成运行时真正需要的二进制数据文件。

4.1 执行内容构建（Content Build）

在Addressables Groups窗口，点击顶部工具栏的Build按钮，你会看到两个主要选项：

1. Clean Build：清除所有之前的构建结果，从头开始构建。在更改了Group设置、资源依赖关系或第一次构建时，必须使用此选项，否则可能出现缓存导致的诡异问题。
2. Update a Previous Build：增量构建。只构建自上次构建以来发生变化的资源组，速度极快。适用于开发中期，只修改了少数资源的情况。

点击Clean Build，选择构建目标（如StandaloneWindows64）。构建过程会在Console窗口有详细日志。

构建完成后，你得到了什么？构建输出目录（默认在Library/com.unity.addressables/aa/[Platform]，如StandaloneWindows64）下会生成：

• addressables_content_state.bin: 记录本次构建所有资源的哈希和依赖关系，是增量构建的依据。
• catalog.json(和.hash文件):资源目录，这是运行时加载的“地图”，记录了所有资源的地址、对应的Bundle文件、依赖信息等。
• *.bundle文件: 实际的AssetBundle数据文件，以你的Group名或资源名命名。
• settings.json: 包含加载路径等配置信息。

4.2 构建脚本与自动化

对于团队项目，手动点击构建不可靠。我们需要将构建过程集成到CI/CD（持续集成/部署）流水线中。

using UnityEditor; using UnityEditor.AddressableAssets; using UnityEditor.AddressableAssets.Settings; using System.Threading.Tasks; using UnityEditor.AddressableAssets.Build; public static class AddressablesBuildMenu { [MenuItem("Tools/Build/Addressables - Clean Build All")] public static async void CleanBuildAll() { // 获取设置 AddressableAssetSettings settings = AddressableAssetSettingsDefaultObject.Settings; if (settings == null) { Debug.LogError("AddressableAssetSettings not found. Initialize Addressables first."); return; } // 设置构建参数 AddressableAssetBuildResult result = null; try { // 执行清理构建 result = AddressableAssetSettings.BuildPlayerContent(); // 或者使用异步API，避免编辑器卡死 // result = await AddressableAssetSettings.BuildPlayerContentAsync().Task; } catch (System.Exception e) { Debug.LogError($"Addressables build failed: {e.Message}"); return; } if (!string.IsNullOrEmpty(result.Error)) { Debug.LogError($"Addressables build error: {result.Error}"); } else { Debug.Log("Addressables build succeeded!"); // 构建成功后，可以在这里触发后续操作，比如复制文件到服务器、生成版本号等 // PostBuildProcess(result.OutputPath); } } [MenuItem("Tools/Build/Addressables - Build for Android")] public static void BuildForAndroid() { // 在构建前，可以动态切换Active Profile到Android对应的配置 EditorUserBuildSettings.SwitchActiveBuildTarget(BuildTargetGroup.Android, BuildTarget.Android); CleanBuildAll(); } }

注意事项：构建路径与版本管理构建输出的*.bundle和catalog.json文件不应该提交到Git等版本控制系统。它们体积大且是二进制文件。应该在.gitignore中添加/[Aa]ssets/AddressableAssetsData/*/*.bundle和/Library/。真正需要提交的是AddressableAssetSettings.asset和各个Group.asset文件，它们定义了“如何构建”。

5. 运行时加载：在代码中驾驭你的资源

一切准备就绪，来到最激动人心的环节——在游戏运行时加载资源。Addressables的加载API全部是异步的，这是现代游戏开发防止卡顿的黄金法则。

5.1 基础加载API详解

加载单个资源（最常用）使用Addressables.LoadAssetAsync<T>()，它返回一个AsyncOperationHandle<T>对象。你需要管理这个句柄（Handle）。

using UnityEngine; using UnityEngine.AddressableAssets; using UnityEngine.ResourceManagement.AsyncOperations; public class ResourceLoader : MonoBehaviour { public string assetAddress = "Hero_Prefab"; // 你在Inspector中设置的Address private AsyncOperationHandle<GameObject> _loadHandle; async void Start() { await LoadAndInstantiateHero(); } async Task LoadAndInstantiateHero() { // 开始异步加载 _loadHandle = Addressables.LoadAssetAsync<GameObject>(assetAddress); // 等待加载完成 await _loadHandle.Task; // 检查加载是否成功 if (_loadHandle.Status == AsyncOperationStatus.Succeeded) { GameObject heroPrefab = _loadHandle.Result; Instantiate(heroPrefab, transform.position, Quaternion.identity); Debug.Log("Hero loaded and instantiated successfully."); } else { Debug.LogError($"Failed to load asset at address: {assetAddress}. Error: {_loadHandle.OperationException}"); } } void OnDestroy() { // 非常重要！当不再需要该资源时，释放它。 if (_loadHandle.IsValid()) { Addressables.Release(_loadHandle); Debug.Log("Released handle for hero asset."); } } }

通过AssetReference加载（类型安全，编辑器友好）AssetReference是一个序列化类，可以直接在Inspector中拖拽资源，避免地址字符串的拼写错误。

using UnityEngine; using UnityEngine.AddressableAssets; public class SafeResourceLoader : MonoBehaviour { // 在Inspector中，将这个字段指向一个已标记为Addressable的Prefab public AssetReferenceGameObject heroAssetReference; private GameObject _spawnedInstance; private AsyncOperationHandle<GameObject> _loadHandle; async void Start() { if (heroAssetReference != null) { // 通过AssetReference加载，同样返回AsyncOperationHandle _loadHandle = heroAssetReference.LoadAssetAsync<GameObject>(); await _loadHandle.Task; if (_loadHandle.Status == AsyncOperationStatus.Succeeded) { _spawnedInstance = Instantiate(_loadHandle.Result, transform.position, Quaternion.identity); } } } void OnDestroy() { if (_loadHandle.IsValid()) { // 释放加载的资源 Addressables.Release(_loadHandle); } // 注意：这里释放的是加载的Asset，不是Instance。 // 如果需要销毁实例并释放实例占用的内存，需要调用 Addressables.ReleaseInstance(_spawnedInstance); if (_spawnedInstance != null) { Addressables.ReleaseInstance(_spawnedInstance); } } }

5.2 加载场景

加载场景与加载Prefab类似，但使用LoadSceneAsync，并且需要管理SceneInstance。

using UnityEngine.SceneManagement; using UnityEngine.ResourceManagement.ResourceProviders; using UnityEngine.ResourceManagement.AsyncOperations; public class SceneLoader : MonoBehaviour { public string sceneAddress = "Assets/Scenes/Level2.unity"; private AsyncOperationHandle<SceneInstance> _sceneLoadHandle; public async void LoadLevelAsync() { // 加载场景模式：Single（关闭当前场景）, Additive（叠加加载） _sceneLoadHandle = Addressables.LoadSceneAsync(sceneAddress, LoadSceneMode.Additive); await _sceneLoadHandle.Task; if (_sceneLoadHandle.Status == AsyncOperationStatus.Succeeded) { SceneInstance loadedScene = _sceneLoadHandle.Result; Debug.Log($"Scene loaded: {loadedScene.Scene.name}"); // 你可以在这里激活场景等操作 // SceneManager.SetActiveScene(loadedScene.Scene); } } public async void UnloadLevelAsync() { if (_sceneLoadHandle.IsValid()) { // 卸载场景 AsyncOperationHandle<SceneInstance> unloadHandle = Addressables.UnloadSceneAsync(_sceneLoadHandle); await unloadHandle.Task; // 注意：卸载操作会返回一个新的Handle，也需要在合适的时候释放。 // 但通常UnloadSceneAsync会内部处理原始_loadHandle的释放。 } } }

5.3 批量加载与标签（Labels）系统

当你需要加载一系列相关资源时（如一个UI界面的所有图集），逐个加载效率低下。这时可以使用标签（Labels）系统。

1. 为资源打标签：在标记资源时，在Labels字段添加标签，如"UI_HUD"。
2. 通过标签批量加载：

public async Task LoadAllUIAssets() { // 加载所有带有"UI_HUD"标签的资源 var loadHandle = Addressables.LoadAssetsAsync<Object>("UI_HUD", null); // 第二个参数是每加载完一个的回调，null表示不使用 await loadHandle.Task; if (loadHandle.Status == AsyncOperationStatus.Succeeded) { // loadHandle.Result 是一个 List<Object>，包含所有加载成功的资源 foreach (var obj in loadHandle.Result) { Debug.Log($"Loaded: {obj.name}"); // 根据类型处理资源... if (obj is Sprite sprite) { /* 处理Sprite */ } if (obj is GameObject prefab) { /* 实例化Prefab */ } } } // 记住，这个handle也需要在适当的时候释放 // Addressables.Release(loadHandle); }

实操心得：内存管理与Handle释放Addressables有引用计数机制。LoadAssetAsync会增加引用计数，Release会减少。当计数为0时，资源才真正从内存卸载。

• 黄金法则：每一个Load或InstantiateAsync调用，都必须对应一个Release。
• 常见错误：在Start中加载，忘记在OnDestroy中释放，导致资源泄漏。
• 对于实例化的对象：使用Addressables.InstantiateAsync实例化，并用Addressables.ReleaseInstance来销毁和释放。如果使用普通的GameObject.Instantiate，则需要确保原始Asset已被释放，且实例用GameObject.Destroy销毁。
• 使用Addressables.ResourceManager.Acquire和Release可以更精细地控制同一资源的多次加载引用。

6. 本地加载实战与调试技巧

我们构建的资源包默认输出到本地（Library文件夹下）。如何在编辑器模式和打包后的游戏中正确加载这些本地资源？

6.1 配置本地加载路径（Profile）

Profile是管理加载路径的关键。默认的DefaultProfile 通常包含LocalBuildPath和LocalLoadPath。

1. 打开Profile管理器：在Addressables Groups窗口，点击Tools>Profiles。
2. 理解变量：你会看到类似[UnityEditorPath]、[BuildPath]的变量。这些是占位符。
   • [UnityEditorPath]：在编辑器模式下，指向项目的Assets文件夹，让你无需构建就能直接加载原始资源（快速迭代）。
   • [BuildPath]/[LocalBuildPath]：构建后资源Bundle的输出路径。
   • [LocalLoadPath]：运行时从本地加载Bundle的路径。对于打好的PC包，这通常指向StreamingAssets目录下的某个位置。
3. 为本地发布创建Profile（可选但推荐）：
   • 复制DefaultProfile，命名为StandaloneLocal。
   • 确保其LocalLoadPath使用的变量（如[BuiltInPath]）最终能解析到打包后资源所在的位置（通常是[UnityEngine.Application.streamingAssetsPath]/[BuildTarget]）。
   • 在构建前，在Addressables Groups窗口的Settings>Profiles中，将Active Profile切换为StandaloneLocal。

6.2 在编辑器中进行测试

在编辑器模式下，Addressables默认使用“Play Mode Script”。你可以在Addressables Groups窗口的Settings>Debug>Play Mode Script中选择：

• Use Asset Database (fastest)：直接从Assets文件夹加载，无需构建。开发阶段首选，速度极快。
• Simulate Groups (advanced)：模拟完整的打包和加载流程，但不真正生成bundle文件。用于测试分组和依赖是否正确。
• Use Existing Build (requires built groups)：使用你之前构建好的bundle文件来运行游戏。最接近真机的模式，用于测试构建后的加载逻辑和性能。

开发工作流建议：平时用Use Asset Database快速迭代；在修改了Group结构或准备测试热更新前，用Simulate Groups或Use Existing Build验证。

6.3 真机本地加载测试

1. 构建Player：在Unity Build Settings中，确保勾选了Build Addressables选项。这样在构建应用程序时，会自动将Addressables资源包复制到StreamingAssets目录。
2. 检查输出：构建完成后，查看生成的游戏数据目录（如.exe同级目录下的YourGame_Data/StreamingAssets/aa/[Platform]），里面应该有你构建的.bundle和catalog.json文件。
3. 运行游戏：如果一切配置正确，游戏运行时Addressables系统会自动从StreamingAssets路径加载这些本地资源。

7. 常见问题、性能优化与进阶方向

7.1 常见问题排查表

7.2 性能优化要点

• 分组策略是性能核心：将同一帧内需要同时加载的资源放在同一个Bundle中。避免一个UI界面所需的图集、预制体、字体散落在多个Bundle里，引发多次IO请求。使用Addressables的Analyze>Check Bundle Layout工具来可视化依赖关系，优化分组。
• 压缩格式选择：
  • LZ4：速度快，支持随机读取（无需全解压即可加载部分资源）。强烈推荐用于本地存储和常驻内存的资源。
  • LZMA：压缩比高，但需要整体解压后才能使用。适用于需要通过网络下载、对包体大小极度敏感的资源。
• 预加载与依赖加载：在进入主场景前，用一个加载场景预加载所有必需的“基础包”（如UI框架、通用音效）。使用Addressables.DownloadDependenciesAsync可以提前下载并缓存一个资源及其所有依赖项。
• 善用引用计数：理解并正确管理AsyncOperationHandle的生命周期。复杂的资源管理可以考虑配合框架（如GameObject池）来统一管理Handle的获取和释放。

7.3 下一步进阶方向

当你熟练掌握了本地加载，Addressables真正的威力在于其对远程资源（热更新）和内容交付网络（CDN）的无缝支持。

1. 远程加载与热更新：

   • 创建一个新的Profile，将RemoteLoadPath设置为你的HTTP服务器地址（如http://your-cdn.com/addressables/[BuildTarget]）。
   • 构建时，选择Build>Update a Previous Build来生成增量更新包。
   • 将生成的.bundle和更新的catalog.json上传到服务器。
   • 游戏启动时，Addressables会自动比较本地和远程的Catalog版本，下载并更新有变化的资源。

2. 内容状态与分包：利用Addressables.ContentState功能，可以记录玩家已下载的内容，实现更精细的更新和资源清理（如删除过期的活动资源）。

3. 自定义资源提供者：如果你有特殊的资源格式或加密需求，可以实现IResourceProvider接口，将其集成到Addressables加载链中。

从本地加载到远程热更新，Addressables提供了一套统一的API。这意味着一开始就基于Addressables架构你的资源系统，将为项目后续的模块化、动态化内容交付打下最坚实的基础。今天的本地加载实践，正是为了明天能从容应对资源热更、分包发布等复杂需求而做的必要准备。