1. 这个需求到底在解决什么问题做Unity开发久了你会发现项目里总是有一堆需要手动配置的数据物品表、技能参数、关卡配置、角色属性、关卡掉落、音效映射、UI文案……早期我见过很多项目用JSON、Excel、甚至把数据硬编码在脚本里然后运行时解析。听起来挺正常的对吧但实际维护起来非常痛苦——改一个数值要打开编辑器改代码、改Excel要写导入工具、内容配错了要等运行时才能发现。后来接触了ScriptableObject配合编辑器菜单在Unity里直接生成Asset文件整个工作流舒服了不止一个档次。所谓Unity3D自定义菜单生成Asset文件并使用说白了就是用MenuItem特性在Unity编辑器顶部或右键菜单里加一个按钮点一下就能用代码创建出ScriptableObject资产文件之后在Inspector里像配置普通资源一样把数据填好运行时直接引用或按路径加载。这套东西能解决什么问题一是把项目里的配置数据变成Unity原生的资源二是让内容策划在不碰代码的前提下完成配置三是把重复性的建文件-设名字-挂脚本-赋初值流程一键化。适合谁看如果你已经在用ScriptableObject但不知道怎么用代码批量生成或者你只会在Inspector里右键Create建资产但没法自动化这篇东西应该能帮到你。新手也能看但至少得知道MenuItem和AssetDatabase这两个名字是干什么的不然我讲得快了你可能跟不上。我下面讲的所有内容我都实际在模拟项目X里跑过代码可以直接抄。2. 环境与基础Editor脚本、MenuItem和ScriptableObject2.1 三个基础概念必须搞清楚在动手之前得先把这三样东西的配合关系理清楚。MenuItem特性它告诉Unity编辑器在某个菜单栏位置注册一个命令。它的构造函数里可以写路径比如写[MenuItem(Assets/Create/生成角色配置)]那这个菜单项就会出现在Assets菜单下右键Project窗口时也能看到。还可以用[MenuItem(Tools/项目工具/批量生成配置)]这种路子出现在顶部菜单栏。路径里的斜杠就是菜单层级。一个很重要的细节是菜单项名字不能重复否则Unity会警告而且后注册的那个会把先注册的顶掉。ScriptableObject它可以理解成一个可以存成文件的数据容器。它继承自UnityEngine.Object但不像GameObject那样挂在场景里而是作为一种资源文件存在Assets目录下。你可以把任意可序列化的字段塞进去Unity的序列化系统会帮你把数据持久化。这个特性天然适合放配置数据因为它是Unity原生的资源类型能进AssetBundle、能进Addressables、能延迟加载、能直接在Inspector里编辑。AssetDatabase这是Unity Editor程序集里提供的资源管理API负责创建、保存、删除、重命名、加载资源文件。它在运行时不可用所以一般只在编辑器脚本里调用。我们要做的生成Asset文件本质就是调用AssetDatabase.CreateAsset()把ScriptableObject实例变成一个.asset文件。三者配合的完整链路是这样的MenuItem提供入口 → 编辑器代码创建ScriptableObject实例并填充默认值 → AssetDatabase把它落地成资产 → 你在Inspector里继续完善配置 → 运行时通过引用或加载方式读取。2.2 目录约定和脚本放置规则编辑器脚本有一个硬性约定如果你的脚本用到了UnityEditor命名空间下的API就必须放在名为Editor的文件夹下可以是任意层的Editor目录否则打包后会报错。这是Unity编译管线决定的不是我们为了规范而规范——Unity会把Editor目录下的代码独立编译成Editor程序集这个程序集不进入发布包。所以凡是和菜单、编辑器窗口、自定义Inspector相关的脚本统统丢进Editor文件夹而存储用的ScriptableObject类本身要放在普通运行时脚本目录里因为打包后运行时还要读它的类型信息。我习惯的目录划分是这样Assets/ Scripts/ Runtime/ Data/ CharacterConfig.cs // ScriptableObject定义运行时需要 ItemConfig.cs Editor/ AssetGenerator/ CharacterConfigGenerator.cs // 菜单生成逻辑只进编辑器这样做的好处是以后发布、打包、热更都清晰。如果你用Asmdef程序集定义那Editor相关的Asmdef里要加上Editor Only的平台限制同时做好对运行时Asmdef的引用。我踩过的一个小坑是ScriptableObject定义文件放在运行时目录但生成工具里用了它结果因为Asmdef没引用对编辑器里报了一堆类型未定义。后来老老实实把引用链配好才消停。3. 核心实现从零写一个菜单项来生成Asset文件3.1 先定义一个能存数据的ScriptableObject假设我们要做一个角色配置管理方案里至少需要存角色的ID、名字、初始血量、攻击力、移动速度这几项。先写一个存数据的类这是运行时用的所以放Assets/Scripts/Runtime/Data/下。using UnityEngine; [CreateAssetMenu(fileName CharacterConfig, menuName 配置/角色配置, order 0)] public class CharacterConfig : ScriptableObject { [Header(基础信息)] public string characterId; public string displayName; [Header(战斗属性)] public float maxHealth 100f; public float attackPower 10f; public float moveSpeed 3.5f; [Header(其他)] [TextArea] public string description; // 一个简单的示例方法运行时可以直接调用 public void DebugInfo() { Debug.Log($角色 {displayName}{characterId}血量 {maxHealth}); } }注意这里我写了[CreateAssetMenu]所以就算不写任何菜单生成脚本你在Project窗口右键也能看到配置/角色配置直接创建。这个特性底层其实就是帮我们做了MenuItem注册。但我们这篇文章讲究的是自定义菜单生成需求往往不只是右键创建空资产而是要批量创建、按模板初始化、自动命名、自动归档这些靠CreateAssetMenu是做不到的。3.2 写一个真正的编辑器生成工具生成逻辑的核心代码就三行创建实例、赋值、保存。但工程化的写法不止这三行因为你要考虑命中重名目录、自动命名、选择新资源、刷新资源数据库、处理冲突等等。下面这个脚本是我项目里实际用的简化版本功能包括一键生成单个角色配置、生成后自动选中、重名时自动加编号。using UnityEngine; using UnityEditor; using System.IO; public class CharacterConfigGenerator { private const string OutputDir Assets/GameData/Characters; [MenuItem(Tools/数据工具/生成角色配置)] public static void GenerateCharacterConfig() { // 1. 确保目标目录存在 if (!Directory.Exists(OutputDir)) { Directory.CreateDirectory(OutputDir); AssetDatabase.Refresh(); } // 2. 创建ScriptableObject实例 CharacterConfig newConfig ScriptableObject.CreateInstanceCharacterConfig(); newConfig.characterId Char_001; newConfig.displayName 新角色; newConfig.maxHealth 100f; newConfig.attackPower 10f; newConfig.moveSpeed 3.5f; // 3. 处理重名自动追加编号 string basePath ${OutputDir}/CharacterConfig.asset; string assetPath GetUniquePath(basePath); // 4. 落地成资产文件 AssetDatabase.CreateAsset(newConfig, assetPath); AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); // 5. 生成后主动选中方便直接编辑 Selection.activeObject newConfig; EditorUtility.FocusProjectWindow(); Debug.Log($角色配置已生成{assetPath}); } private static string GetUniquePath(string basePath) { string dir Path.GetDirectoryName(basePath); string fileName Path.GetFileNameWithoutExtension(basePath); string ext Path.GetExtension(basePath); string path basePath; int index 1; while (AssetDatabase.LoadAssetAtPathObject(path) ! null) { path ${dir}/{fileName}_{index}{ext}; index; } return path; } }这段代码看着不长但里面的细节值得逐行讲一下不然你自己写的时候很容易在看不见的地方翻车。为什么用ScriptableObject.CreateInstanceT()而不是new CharacterConfig()这俩在编辑器里跑起来通常都能出对象但CreateInstance走的是Unity对象的正规创建路径保证对象被Unity引擎正确识别资源管线、序列化、生命周期都正常。我见过有人用new创建然后CreateAssetUnity倒是没报错但极端情况下比如带有隐藏引擎字段、需要Awake初始化会出现对象状态异常。养成习惯创建Unity对象统一走工厂API。AssetDatabase.CreateAsset的路径必须是相对Assets目录的完整路径而且目录必须存在。这一步是最容易出错的路径写错、目录没建好Unity会直接报Couldnt create asset file。所以我在生成前先用Directory.CreateDirectory把目录建好再调用AssetDatabase.Refresh()让Unity感知新目录。别小看这个Refresh我之前漏掉它结果CreateAsset报错说目录不存在——因为Unity的资源数据库还没刷新物理上目录已经建了但Unity内部索引里还没有。GetUniquePath里为什么用AssetDatabase.LoadAssetAtPath判断重名因为同一个路径下如果已经有一个asset文件挡住了CreateAsset会把旧文件直接覆盖掉。覆盖本身不报错但你的数据就丢了。用LoadAssetAtPath判断路径是否已有资源是比较保险的做法它比File.Exists靠谱的地方是它能同时识别Unity资源数据库的状态不怕Assets目录之外或Library缓存里的脏数据干扰。AssetDatabase.SaveAssets()和AssetDatabase.Refresh()到底要不要都调用我的习惯是CreateAsset之后补一个SaveAssets确保改动确实写到磁盘最后Refresh是让整个资源数据库同步一下尤其是当你有Import Settings、材质球、预制体等关联依赖时不刷新有时候会出现资源显示旧数据的怪现象。你说这两个API是不是重复在大多数轻量场景里不调SaveAssetsUnity在切回主线程空闲时也会自动保存但写工具讲究的是确定性——我点了菜单马上看到文件出现、Inspector刷新、数据不丢这就要SaveAssets和Refresh双保险。3.3 菜单权限控制和快捷键MenuItem还有一个很实用的重载[MenuItem(string itemName, bool isValidateFunction, int priority)]。第一个参数是路径第二个表示是否作为校验函数第三个是菜单排序优先级数值越小越靠前。校验函数的作用是让菜单项根据当前状态置灰或隐藏。举个例子我希望只在选中了一个文件夹时才允许执行生成角色配置菜单不然容易生成到乱七八糟的位置。可以这样写[MenuItem(Assets/生成角色配置到选中目录, true)] private static bool ValidateGenerateToSelected() { // 校验函数返回false时菜单置灰 return Selection.activeObject is DefaultAsset; } [MenuItem(Assets/生成角色配置到选中目录, false, 20)] private static void GenerateToSelected() { string selectedPath AssetDatabase.GetAssetPath(Selection.activeObject); // 然后走到生成逻辑 }同路径同名字的两个MenuItem一个校验函数一个执行函数Unity会识别这个配对。优先级数字可以控制菜单在右键菜单里的位置比如10左右是Create组附近20以上会排得比较靠后。再说快捷键MenuItem路径里支持特殊字符。%代表CtrlMac上是Cmd#代表Shift代表Alt字母直接跟在后面。比如[MenuItem(Tools/数据工具/生成角色配置 %#g)]就是CtrlShiftG触发。快捷键很好用但我建议团队协作时别设太多全局快捷键容易和别人装的插件冲突。我遇到过两次一次是和其他工具绑定同一个快捷键菜单显示两个同路径项另一次是快捷键被IDE抢了怎么按都没反应。后来项目里统一了按键规范菜单路径也做了命名空间约束。3.4 生成后的资源自动赋初值很多时候批量生成不只是生成空壳而是要顺手把初始数据从别处搬过来。比如从Excel导出的JSON里读角色表然后每个角色生成一个对应的的asset文件。这在内容量大的项目里几乎是个刚需下面这节我展开讲下怎么做。4. 进阶场景批量生成与数据驱动4.1 从JSON批量生成多个Asset文件假设你的策划维护了一张JSON表里面是几十个角色的初始配置。你可以写个菜单一键把这批配置全部转成.asset文件。思路很简单读取JSON → 遍历列表 → 对每条数据执行生成逻辑。using UnityEngine; using UnityEditor; using System.IO; using System.Collections.Generic; public class CharacterConfigBatchGenerator { private const string ConfigPath Assets/Editor/ImportData/character_data.json; private const string OutputDir Assets/GameData/Characters; [MenuItem(Tools/数据工具/从JSON批量生成角色配置)] public static void GenerateFromJson() { if (!File.Exists(ConfigPath)) { Debug.LogError($配置文件不存在{ConfigPath}); return; } string json File.ReadAllText(ConfigPath); // 这里假设JSON是一个对象数组每个元素有id/name/hp/attack字段 CharacterDataList dataList JsonUtility.FromJsonCharacterDataList(json); if (dataList null || dataList.characters null) { Debug.LogError(JSON解析失败请检查格式); return; } foreach (var item in dataList.characters) { CharacterConfig config ScriptableObject.CreateInstanceCharacterConfig(); config.characterId item.id; config.displayName item.name; config.maxHealth item.hp; config.attackPower item.attack; string assetPath ${OutputDir}/{item.id}.asset; assetPath GetUniquePath(assetPath); AssetDatabase.CreateAsset(config, assetPath); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); Debug.Log($批量生成完成{dataList.characters.Count} 个角色配置); } [System.Serializable] public class CharacterDataList { public ListCharacterData characters; } [System.Serializable] public class CharacterData { public string id; public string name; public float hp; public float attack; } }这里的JSON格式不是随便定的我用的是JsonUtility支持的格式。注意一点JsonUtility不支持直接解析顶层数组所以外面必须包一层对象这是Unity的官方限制绕不过去。如果你想直接用Newtonsoft.Json那当然也能跑但项目里如果没有引入这个库就别为一个导入工具增加依赖。还有一个值得注意的点是批量生成前最好先做字段校验。我早期写过一版不加校验的结果JSON里有个角色的id是空的生成的asset文件名直接变成了.assetUnity虽然没报错但那个文件在资源数据库里就是个畸形资产后面加载的时候各种莫名其妙。这在数据驱动工作流里是个典型的坑。4.2 生成Assets时的字段校验和数据规范我强烈建议在每个批量生成工具里都加上字段校验哪怕是最简单的那种。比如必填字段为空直接跳过并记录日志数值超出合理范围给出警告id不能重复id里不能包含特殊字符因为文件名不允许某些字符如果字段内容本身毫无意义校验失败后工具应该停下来而不是继续生成一堆垃圾资产。校验不通过怎么办两种策略一种是跳过该条继续生成后面的最后汇总报告另一种是直接中断整个生成流程错误修完再重跑。我个人的习惯是如果是脏数据空id、重复id这种问题直接中断更安全因为后续处理逻辑很可能依赖前面生成的文件生成一半的状态最麻烦如果是警告级别的问题数值偏大、名字太短就跳过并记录最后统一看报告。4.3 覆盖更新与保留手工修改的内容这是一个比较微妙的需求JSON里的数据是策划维护的原始数据但.asset文件在Unity里可能被美术或者程序额外编辑过比如添加了备注、调整了某个不参与导出的字段。这时你重新从JSON生成到底该不该覆盖我见过的几种处理方式全量覆盖最简单但会把手工改动全部冲掉适合数据源头唯一、Unity里不允许编辑的配置跳过已存在文件生成前检查文件是否已经存在存在就跳过适合只需要初版生成的场景只更新指定字段从JSON读取数据到内存对象再和已有资产合并适合混合编辑模式。具体到实现第三种方式代码也不复杂。核心就是先LoadAssetAtPath拿到已有对象然后只给对应字段赋值最后EditorUtility.SetDirty标记脏数据让它保存。这里有一个很容易忽略的点CreateAsset只能用于从未存在的资产文件如果你对已有.asset文件调用CreateAssetUnity会把原文件覆盖成新对象。所以更新已有资产的正确姿势是加载已有对象并修改而不是重新CreateAsset。CharacterConfig existing AssetDatabase.LoadAssetAtPathCharacterConfig(assetPath); if (existing null) { existing ScriptableObject.CreateInstanceCharacterConfig(); AssetDatabase.CreateAsset(existing, assetPath); } existing.characterId item.id; existing.displayName item.name; existing.maxHealth item.hp; existing.attackPower item.attack; EditorUtility.SetDirty(existing);用EditorUtility.SetDirty标记之后退出编辑器或主动SaveAssets时会落盘。这种渐进式更新对团队协作很友好因为每个人在Unity里手动补充的内容不会被无脑冲掉。5. 运行时使用与常见问题排查5.1 在游戏代码里安全地读取Asset文件生成好.asset文件之后接下来就是运行时怎么读取。常见两种情况编辑器里调试和正式构建后使用。编辑器里调试最简单直接把asset文件的引用拖到脚本的public CharacterConfig config字段上就行。运行时加载的话根据你项目的资源管理方式有不同选择如果资产直接放在Assets目录下且参与构建可以用Resources.LoadCharacterConfig(Characters/Char_001)前提是你把资产放在Resources目录或其子目录下如果项目用Addressables那把资产打进Addressables组里运行时Addressables.LoadAssetAsyncCharacterConfig(key)加载如果走AssetBundle资产要先打进Bundle再按Bundle路径加载。资源加载这块是另一个大话题不展开。但我必须提醒一个和自定义Asset配套的问题当你在运行时需要动态创建配置数据的副本时别直接改共享资产。这话什么意思比如角色的血量在战斗中会被临时修改你不能直接改CharacterConfig.maxHealth因为这是所有角色共用的配置资产改了等于全局污染。正确做法是运行时Instantiate一份配置副本或者把可变状态放到另一个运行时数据类里。5.2 编辑器模式下立即使用生成的资产有些工作流需要在生成资产后立刻在代码里读取它的值做后续操作。比如批量生成完地图配置后马上用配置数据刷新Scene视图里的预览物件。手动方式是通过AssetDatabase.LoadAssetAtPathT(path)加载但如果你刚CreateAsset完还没Refresh可能会遇到加载不到的情况。稳妥的做法是先Refresh再Load。AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); CharacterConfig loadedConfig AssetDatabase.LoadAssetAtPathCharacterConfig(assetPath);还有一个细节编辑器代码里创建完ScriptableObject后直接引用对象也是可以读取字段的不需要先落盘再读取。newConfig.characterId直接能拿到。但如果你想验证从磁盘加载这整条链路是否正常那就必须走LoadAssetAtPath这样才是模拟运行时加载的真实路径。5.3 常见问题速查表我整理了一份自己踩过的坑的排查清单按出现频率排序现象可能原因解决办法菜单项不显示Editor脚本没放在Editor目录下把脚本移到Editor文件夹或者添加Editor Asmdef菜单项显示但点了无反应执行方法被static关键字漏掉MenuItem绑定方法必须是staticCreateAsset报目录不存在目标目录物理上不存在或Unity资源库未刷新先Directory.CreateDirectory再AssetDatabase.Refresh生成文件名重复导致覆盖没有做唯一性判断用LoadAssetAtPath判断后追加编号JsonUtility解析不出数据JSON是顶层数组包了一层对象用包装类接收数组生成的资产Inspector里显示空白创建时没执行SaveAssets/Refresh补上AssetDatabase.SaveAssets和Refresh打包后运行时读取不到配置资产不在Resources/Addressables/Bundle里检查资产是否参与构建SetDirty后数据没写入没触发保存调用AssetDatabase.SaveAssets或等编辑器自动保存这表里最后一条我要多说一句EditorUtility.SetDirty标记的对象如果在编辑器退出前没有被保存数据就丢了。写工具时强烈建议在关键步骤后显式调用AssetDatabase.SaveAssets()尤其是批量生成几百个资产时别指望编辑器自动保存帮你兜底。5.4 怎么避免生成工具变成一次性脚本很多团队写完一个生成工具就跑路了后续没人维护。等到策划改了数据格式、新增了字段才发现之前的工具没法复用。我自己的几个经验用常量管理路径输出目录、JSON路径全部抽成常量后续变动只改一处日志打全生成成功的路径、跳过原因、失败原因全部用Debug.Log输出方便排查可复用的核心方法单独封装比如GetUniquePath、EnsureDirectoryExists这种方法以后其他生成工具也要用抽到公共工具类里给菜单分组时带上项目前缀比如Tools/项目名/数据工具/XXX避免和第三方插件混在一起。另外生成工具要支持撤销吗说实话AssetDatabase.CreateAsset创建的资产文件不在Undo系统记录范围内想让用户按CtrlZ撤销是不可能的。所以我在团队规范里明确要求批量生成前建议用版本管理工具打好基线或者先导出当前Assets目录快照。做工具的人要意识到生成操作不可逆谨慎设计总没错。6. 几个我实际用过的小技巧最后分享几个不算核心但很实用的边角料。如果你希望生成资产的时候自动给文件设置AssetBundle标签或者Addressable地址可以在CreateAsset之后调用AssetImporter.GetAtPath(assetPath)拿到importer后设置SetAssetBundleNameAndVariant再SaveAndReimport。这样一键生成完资源系统就已经把路铺好了。这个技巧特别适合关卡配置这类一定要进包里的数据。如果用CreateAssetMenu创建资产Unity默认会把新资产和当前选中的文件夹对齐。但如果你自己写生成工具路径是自己定的生成完最好用EditorUtility.FocusProjectWindow()和Selection.activeObject把焦点拉过去。别小看这一步文件在磁盘上生成了但编辑器界面没刷新策划同事会以为工具坏了。还有一个小事ScriptableObject类的字段命名尽量和策划表头语言统一。中文表就统一中文注释英文表就统一英文字段名半中半英的注释维护起来很痛苦。我见过最头疼的代码是字段名拼音缩写加英文字母混合团队换了两个人之后谁都看不懂了。配置资产字段的命名直接影响所有配置人的使用体验值得多花点心思。 
长河君 · 2026/10/17 9:16:07 · 阅读 1.2k Unity3D自定义菜单生成Asset文件：ScriptableObject自动化配置实践
1. 这个需求到底在解决什么问题做Unity开发久了你会发现项目里总是有一堆需要手动配置的数据物品表、技能参数、关卡配置、角色属性、关卡掉落、音效映射、UI文案……早期我见过很多项目用JSON、Excel、甚至把数据硬编码在脚本里然后运行时解析。听起来挺正常的对吧但实际维护起来非常痛苦——改一个数值要打开编辑器改代码、改Excel要写导入工具、内容配错了要等运行时才能发现。后来接触了ScriptableObject配合编辑器菜单在Unity里直接生成Asset文件整个工作流舒服了不止一个档次。所谓Unity3D自定义菜单生成Asset文件并使用说白了就是用MenuItem特性在Unity编辑器顶部或右键菜单里加一个按钮点一下就能用代码创建出ScriptableObject资产文件之后在Inspector里像配置普通资源一样把数据填好运行时直接引用或按路径加载。这套东西能解决什么问题一是把项目里的配置数据变成Unity原生的资源二是让内容策划在不碰代码的前提下完成配置三是把重复性的建文件-设名字-挂脚本-赋初值流程一键化。适合谁看如果你已经在用ScriptableObject但不知道怎么用代码批量生成或者你只会在Inspector里右键Create建资产但没法自动化这篇东西应该能帮到你。新手也能看但至少得知道MenuItem和AssetDatabase这两个名字是干什么的不然我讲得快了你可能跟不上。我下面讲的所有内容我都实际在模拟项目X里跑过代码可以直接抄。2. 环境与基础Editor脚本、MenuItem和ScriptableObject2.1 三个基础概念必须搞清楚在动手之前得先把这三样东西的配合关系理清楚。MenuItem特性它告诉Unity编辑器在某个菜单栏位置注册一个命令。它的构造函数里可以写路径比如写[MenuItem(Assets/Create/生成角色配置)]那这个菜单项就会出现在Assets菜单下右键Project窗口时也能看到。还可以用[MenuItem(Tools/项目工具/批量生成配置)]这种路子出现在顶部菜单栏。路径里的斜杠就是菜单层级。一个很重要的细节是菜单项名字不能重复否则Unity会警告而且后注册的那个会把先注册的顶掉。ScriptableObject它可以理解成一个可以存成文件的数据容器。它继承自UnityEngine.Object但不像GameObject那样挂在场景里而是作为一种资源文件存在Assets目录下。你可以把任意可序列化的字段塞进去Unity的序列化系统会帮你把数据持久化。这个特性天然适合放配置数据因为它是Unity原生的资源类型能进AssetBundle、能进Addressables、能延迟加载、能直接在Inspector里编辑。AssetDatabase这是Unity Editor程序集里提供的资源管理API负责创建、保存、删除、重命名、加载资源文件。它在运行时不可用所以一般只在编辑器脚本里调用。我们要做的生成Asset文件本质就是调用AssetDatabase.CreateAsset()把ScriptableObject实例变成一个.asset文件。三者配合的完整链路是这样的MenuItem提供入口 → 编辑器代码创建ScriptableObject实例并填充默认值 → AssetDatabase把它落地成资产 → 你在Inspector里继续完善配置 → 运行时通过引用或加载方式读取。2.2 目录约定和脚本放置规则编辑器脚本有一个硬性约定如果你的脚本用到了UnityEditor命名空间下的API就必须放在名为Editor的文件夹下可以是任意层的Editor目录否则打包后会报错。这是Unity编译管线决定的不是我们为了规范而规范——Unity会把Editor目录下的代码独立编译成Editor程序集这个程序集不进入发布包。所以凡是和菜单、编辑器窗口、自定义Inspector相关的脚本统统丢进Editor文件夹而存储用的ScriptableObject类本身要放在普通运行时脚本目录里因为打包后运行时还要读它的类型信息。我习惯的目录划分是这样Assets/ Scripts/ Runtime/ Data/ CharacterConfig.cs // ScriptableObject定义运行时需要 ItemConfig.cs Editor/ AssetGenerator/ CharacterConfigGenerator.cs // 菜单生成逻辑只进编辑器这样做的好处是以后发布、打包、热更都清晰。如果你用Asmdef程序集定义那Editor相关的Asmdef里要加上Editor Only的平台限制同时做好对运行时Asmdef的引用。我踩过的一个小坑是ScriptableObject定义文件放在运行时目录但生成工具里用了它结果因为Asmdef没引用对编辑器里报了一堆类型未定义。后来老老实实把引用链配好才消停。3. 核心实现从零写一个菜单项来生成Asset文件3.1 先定义一个能存数据的ScriptableObject假设我们要做一个角色配置管理方案里至少需要存角色的ID、名字、初始血量、攻击力、移动速度这几项。先写一个存数据的类这是运行时用的所以放Assets/Scripts/Runtime/Data/下。using UnityEngine; [CreateAssetMenu(fileName CharacterConfig, menuName 配置/角色配置, order 0)] public class CharacterConfig : ScriptableObject { [Header(基础信息)] public string characterId; public string displayName; [Header(战斗属性)] public float maxHealth 100f; public float attackPower 10f; public float moveSpeed 3.5f; [Header(其他)] [TextArea] public string description; // 一个简单的示例方法运行时可以直接调用 public void DebugInfo() { Debug.Log($角色 {displayName}{characterId}血量 {maxHealth}); } }注意这里我写了[CreateAssetMenu]所以就算不写任何菜单生成脚本你在Project窗口右键也能看到配置/角色配置直接创建。这个特性底层其实就是帮我们做了MenuItem注册。但我们这篇文章讲究的是自定义菜单生成需求往往不只是右键创建空资产而是要批量创建、按模板初始化、自动命名、自动归档这些靠CreateAssetMenu是做不到的。3.2 写一个真正的编辑器生成工具生成逻辑的核心代码就三行创建实例、赋值、保存。但工程化的写法不止这三行因为你要考虑命中重名目录、自动命名、选择新资源、刷新资源数据库、处理冲突等等。下面这个脚本是我项目里实际用的简化版本功能包括一键生成单个角色配置、生成后自动选中、重名时自动加编号。using UnityEngine; using UnityEditor; using System.IO; public class CharacterConfigGenerator { private const string OutputDir Assets/GameData/Characters; [MenuItem(Tools/数据工具/生成角色配置)] public static void GenerateCharacterConfig() { // 1. 确保目标目录存在 if (!Directory.Exists(OutputDir)) { Directory.CreateDirectory(OutputDir); AssetDatabase.Refresh(); } // 2. 创建ScriptableObject实例 CharacterConfig newConfig ScriptableObject.CreateInstanceCharacterConfig(); newConfig.characterId Char_001; newConfig.displayName 新角色; newConfig.maxHealth 100f; newConfig.attackPower 10f; newConfig.moveSpeed 3.5f; // 3. 处理重名自动追加编号 string basePath ${OutputDir}/CharacterConfig.asset; string assetPath GetUniquePath(basePath); // 4. 落地成资产文件 AssetDatabase.CreateAsset(newConfig, assetPath); AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); // 5. 生成后主动选中方便直接编辑 Selection.activeObject newConfig; EditorUtility.FocusProjectWindow(); Debug.Log($角色配置已生成{assetPath}); } private static string GetUniquePath(string basePath) { string dir Path.GetDirectoryName(basePath); string fileName Path.GetFileNameWithoutExtension(basePath); string ext Path.GetExtension(basePath); string path basePath; int index 1; while (AssetDatabase.LoadAssetAtPathObject(path) ! null) { path ${dir}/{fileName}_{index}{ext}; index; } return path; } }这段代码看着不长但里面的细节值得逐行讲一下不然你自己写的时候很容易在看不见的地方翻车。为什么用ScriptableObject.CreateInstanceT()而不是new CharacterConfig()这俩在编辑器里跑起来通常都能出对象但CreateInstance走的是Unity对象的正规创建路径保证对象被Unity引擎正确识别资源管线、序列化、生命周期都正常。我见过有人用new创建然后CreateAssetUnity倒是没报错但极端情况下比如带有隐藏引擎字段、需要Awake初始化会出现对象状态异常。养成习惯创建Unity对象统一走工厂API。AssetDatabase.CreateAsset的路径必须是相对Assets目录的完整路径而且目录必须存在。这一步是最容易出错的路径写错、目录没建好Unity会直接报Couldnt create asset file。所以我在生成前先用Directory.CreateDirectory把目录建好再调用AssetDatabase.Refresh()让Unity感知新目录。别小看这个Refresh我之前漏掉它结果CreateAsset报错说目录不存在——因为Unity的资源数据库还没刷新物理上目录已经建了但Unity内部索引里还没有。GetUniquePath里为什么用AssetDatabase.LoadAssetAtPath判断重名因为同一个路径下如果已经有一个asset文件挡住了CreateAsset会把旧文件直接覆盖掉。覆盖本身不报错但你的数据就丢了。用LoadAssetAtPath判断路径是否已有资源是比较保险的做法它比File.Exists靠谱的地方是它能同时识别Unity资源数据库的状态不怕Assets目录之外或Library缓存里的脏数据干扰。AssetDatabase.SaveAssets()和AssetDatabase.Refresh()到底要不要都调用我的习惯是CreateAsset之后补一个SaveAssets确保改动确实写到磁盘最后Refresh是让整个资源数据库同步一下尤其是当你有Import Settings、材质球、预制体等关联依赖时不刷新有时候会出现资源显示旧数据的怪现象。你说这两个API是不是重复在大多数轻量场景里不调SaveAssetsUnity在切回主线程空闲时也会自动保存但写工具讲究的是确定性——我点了菜单马上看到文件出现、Inspector刷新、数据不丢这就要SaveAssets和Refresh双保险。3.3 菜单权限控制和快捷键MenuItem还有一个很实用的重载[MenuItem(string itemName, bool isValidateFunction, int priority)]。第一个参数是路径第二个表示是否作为校验函数第三个是菜单排序优先级数值越小越靠前。校验函数的作用是让菜单项根据当前状态置灰或隐藏。举个例子我希望只在选中了一个文件夹时才允许执行生成角色配置菜单不然容易生成到乱七八糟的位置。可以这样写[MenuItem(Assets/生成角色配置到选中目录, true)] private static bool ValidateGenerateToSelected() { // 校验函数返回false时菜单置灰 return Selection.activeObject is DefaultAsset; } [MenuItem(Assets/生成角色配置到选中目录, false, 20)] private static void GenerateToSelected() { string selectedPath AssetDatabase.GetAssetPath(Selection.activeObject); // 然后走到生成逻辑 }同路径同名字的两个MenuItem一个校验函数一个执行函数Unity会识别这个配对。优先级数字可以控制菜单在右键菜单里的位置比如10左右是Create组附近20以上会排得比较靠后。再说快捷键MenuItem路径里支持特殊字符。%代表CtrlMac上是Cmd#代表Shift代表Alt字母直接跟在后面。比如[MenuItem(Tools/数据工具/生成角色配置 %#g)]就是CtrlShiftG触发。快捷键很好用但我建议团队协作时别设太多全局快捷键容易和别人装的插件冲突。我遇到过两次一次是和其他工具绑定同一个快捷键菜单显示两个同路径项另一次是快捷键被IDE抢了怎么按都没反应。后来项目里统一了按键规范菜单路径也做了命名空间约束。3.4 生成后的资源自动赋初值很多时候批量生成不只是生成空壳而是要顺手把初始数据从别处搬过来。比如从Excel导出的JSON里读角色表然后每个角色生成一个对应的的asset文件。这在内容量大的项目里几乎是个刚需下面这节我展开讲下怎么做。4. 进阶场景批量生成与数据驱动4.1 从JSON批量生成多个Asset文件假设你的策划维护了一张JSON表里面是几十个角色的初始配置。你可以写个菜单一键把这批配置全部转成.asset文件。思路很简单读取JSON → 遍历列表 → 对每条数据执行生成逻辑。using UnityEngine; using UnityEditor; using System.IO; using System.Collections.Generic; public class CharacterConfigBatchGenerator { private const string ConfigPath Assets/Editor/ImportData/character_data.json; private const string OutputDir Assets/GameData/Characters; [MenuItem(Tools/数据工具/从JSON批量生成角色配置)] public static void GenerateFromJson() { if (!File.Exists(ConfigPath)) { Debug.LogError($配置文件不存在{ConfigPath}); return; } string json File.ReadAllText(ConfigPath); // 这里假设JSON是一个对象数组每个元素有id/name/hp/attack字段 CharacterDataList dataList JsonUtility.FromJsonCharacterDataList(json); if (dataList null || dataList.characters null) { Debug.LogError(JSON解析失败请检查格式); return; } foreach (var item in dataList.characters) { CharacterConfig config ScriptableObject.CreateInstanceCharacterConfig(); config.characterId item.id; config.displayName item.name; config.maxHealth item.hp; config.attackPower item.attack; string assetPath ${OutputDir}/{item.id}.asset; assetPath GetUniquePath(assetPath); AssetDatabase.CreateAsset(config, assetPath); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); Debug.Log($批量生成完成{dataList.characters.Count} 个角色配置); } [System.Serializable] public class CharacterDataList { public ListCharacterData characters; } [System.Serializable] public class CharacterData { public string id; public string name; public float hp; public float attack; } }这里的JSON格式不是随便定的我用的是JsonUtility支持的格式。注意一点JsonUtility不支持直接解析顶层数组所以外面必须包一层对象这是Unity的官方限制绕不过去。如果你想直接用Newtonsoft.Json那当然也能跑但项目里如果没有引入这个库就别为一个导入工具增加依赖。还有一个值得注意的点是批量生成前最好先做字段校验。我早期写过一版不加校验的结果JSON里有个角色的id是空的生成的asset文件名直接变成了.assetUnity虽然没报错但那个文件在资源数据库里就是个畸形资产后面加载的时候各种莫名其妙。这在数据驱动工作流里是个典型的坑。4.2 生成Assets时的字段校验和数据规范我强烈建议在每个批量生成工具里都加上字段校验哪怕是最简单的那种。比如必填字段为空直接跳过并记录日志数值超出合理范围给出警告id不能重复id里不能包含特殊字符因为文件名不允许某些字符如果字段内容本身毫无意义校验失败后工具应该停下来而不是继续生成一堆垃圾资产。校验不通过怎么办两种策略一种是跳过该条继续生成后面的最后汇总报告另一种是直接中断整个生成流程错误修完再重跑。我个人的习惯是如果是脏数据空id、重复id这种问题直接中断更安全因为后续处理逻辑很可能依赖前面生成的文件生成一半的状态最麻烦如果是警告级别的问题数值偏大、名字太短就跳过并记录最后统一看报告。4.3 覆盖更新与保留手工修改的内容这是一个比较微妙的需求JSON里的数据是策划维护的原始数据但.asset文件在Unity里可能被美术或者程序额外编辑过比如添加了备注、调整了某个不参与导出的字段。这时你重新从JSON生成到底该不该覆盖我见过的几种处理方式全量覆盖最简单但会把手工改动全部冲掉适合数据源头唯一、Unity里不允许编辑的配置跳过已存在文件生成前检查文件是否已经存在存在就跳过适合只需要初版生成的场景只更新指定字段从JSON读取数据到内存对象再和已有资产合并适合混合编辑模式。具体到实现第三种方式代码也不复杂。核心就是先LoadAssetAtPath拿到已有对象然后只给对应字段赋值最后EditorUtility.SetDirty标记脏数据让它保存。这里有一个很容易忽略的点CreateAsset只能用于从未存在的资产文件如果你对已有.asset文件调用CreateAssetUnity会把原文件覆盖成新对象。所以更新已有资产的正确姿势是加载已有对象并修改而不是重新CreateAsset。CharacterConfig existing AssetDatabase.LoadAssetAtPathCharacterConfig(assetPath); if (existing null) { existing ScriptableObject.CreateInstanceCharacterConfig(); AssetDatabase.CreateAsset(existing, assetPath); } existing.characterId item.id; existing.displayName item.name; existing.maxHealth item.hp; existing.attackPower item.attack; EditorUtility.SetDirty(existing);用EditorUtility.SetDirty标记之后退出编辑器或主动SaveAssets时会落盘。这种渐进式更新对团队协作很友好因为每个人在Unity里手动补充的内容不会被无脑冲掉。5. 运行时使用与常见问题排查5.1 在游戏代码里安全地读取Asset文件生成好.asset文件之后接下来就是运行时怎么读取。常见两种情况编辑器里调试和正式构建后使用。编辑器里调试最简单直接把asset文件的引用拖到脚本的public CharacterConfig config字段上就行。运行时加载的话根据你项目的资源管理方式有不同选择如果资产直接放在Assets目录下且参与构建可以用Resources.LoadCharacterConfig(Characters/Char_001)前提是你把资产放在Resources目录或其子目录下如果项目用Addressables那把资产打进Addressables组里运行时Addressables.LoadAssetAsyncCharacterConfig(key)加载如果走AssetBundle资产要先打进Bundle再按Bundle路径加载。资源加载这块是另一个大话题不展开。但我必须提醒一个和自定义Asset配套的问题当你在运行时需要动态创建配置数据的副本时别直接改共享资产。这话什么意思比如角色的血量在战斗中会被临时修改你不能直接改CharacterConfig.maxHealth因为这是所有角色共用的配置资产改了等于全局污染。正确做法是运行时Instantiate一份配置副本或者把可变状态放到另一个运行时数据类里。5.2 编辑器模式下立即使用生成的资产有些工作流需要在生成资产后立刻在代码里读取它的值做后续操作。比如批量生成完地图配置后马上用配置数据刷新Scene视图里的预览物件。手动方式是通过AssetDatabase.LoadAssetAtPathT(path)加载但如果你刚CreateAsset完还没Refresh可能会遇到加载不到的情况。稳妥的做法是先Refresh再Load。AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); CharacterConfig loadedConfig AssetDatabase.LoadAssetAtPathCharacterConfig(assetPath);还有一个细节编辑器代码里创建完ScriptableObject后直接引用对象也是可以读取字段的不需要先落盘再读取。newConfig.characterId直接能拿到。但如果你想验证从磁盘加载这整条链路是否正常那就必须走LoadAssetAtPath这样才是模拟运行时加载的真实路径。5.3 常见问题速查表我整理了一份自己踩过的坑的排查清单按出现频率排序现象可能原因解决办法菜单项不显示Editor脚本没放在Editor目录下把脚本移到Editor文件夹或者添加Editor Asmdef菜单项显示但点了无反应执行方法被static关键字漏掉MenuItem绑定方法必须是staticCreateAsset报目录不存在目标目录物理上不存在或Unity资源库未刷新先Directory.CreateDirectory再AssetDatabase.Refresh生成文件名重复导致覆盖没有做唯一性判断用LoadAssetAtPath判断后追加编号JsonUtility解析不出数据JSON是顶层数组包了一层对象用包装类接收数组生成的资产Inspector里显示空白创建时没执行SaveAssets/Refresh补上AssetDatabase.SaveAssets和Refresh打包后运行时读取不到配置资产不在Resources/Addressables/Bundle里检查资产是否参与构建SetDirty后数据没写入没触发保存调用AssetDatabase.SaveAssets或等编辑器自动保存这表里最后一条我要多说一句EditorUtility.SetDirty标记的对象如果在编辑器退出前没有被保存数据就丢了。写工具时强烈建议在关键步骤后显式调用AssetDatabase.SaveAssets()尤其是批量生成几百个资产时别指望编辑器自动保存帮你兜底。5.4 怎么避免生成工具变成一次性脚本很多团队写完一个生成工具就跑路了后续没人维护。等到策划改了数据格式、新增了字段才发现之前的工具没法复用。我自己的几个经验用常量管理路径输出目录、JSON路径全部抽成常量后续变动只改一处日志打全生成成功的路径、跳过原因、失败原因全部用Debug.Log输出方便排查可复用的核心方法单独封装比如GetUniquePath、EnsureDirectoryExists这种方法以后其他生成工具也要用抽到公共工具类里给菜单分组时带上项目前缀比如Tools/项目名/数据工具/XXX避免和第三方插件混在一起。另外生成工具要支持撤销吗说实话AssetDatabase.CreateAsset创建的资产文件不在Undo系统记录范围内想让用户按CtrlZ撤销是不可能的。所以我在团队规范里明确要求批量生成前建议用版本管理工具打好基线或者先导出当前Assets目录快照。做工具的人要意识到生成操作不可逆谨慎设计总没错。6. 几个我实际用过的小技巧最后分享几个不算核心但很实用的边角料。如果你希望生成资产的时候自动给文件设置AssetBundle标签或者Addressable地址可以在CreateAsset之后调用AssetImporter.GetAtPath(assetPath)拿到importer后设置SetAssetBundleNameAndVariant再SaveAndReimport。这样一键生成完资源系统就已经把路铺好了。这个技巧特别适合关卡配置这类一定要进包里的数据。如果用CreateAssetMenu创建资产Unity默认会把新资产和当前选中的文件夹对齐。但如果你自己写生成工具路径是自己定的生成完最好用EditorUtility.FocusProjectWindow()和Selection.activeObject把焦点拉过去。别小看这一步文件在磁盘上生成了但编辑器界面没刷新策划同事会以为工具坏了。还有一个小事ScriptableObject类的字段命名尽量和策划表头语言统一。中文表就统一中文注释英文表就统一英文字段名半中半英的注释维护起来很痛苦。我见过最头疼的代码是字段名拼音缩写加英文字母混合团队换了两个人之后谁都看不懂了。配置资产字段的命名直接影响所有配置人的使用体验值得多花点心思。