在Unity項(xiàng)目里ScriptableObject大概是除了Prefab和Scene之外最常用來存配置的東西了。但相信很多人都有過這種體驗(yàn)需求一改幾十個配置資產(chǎn)要一個一個點(diǎn)開改策劃給了一張表你要手動在Inspector里把幾十條數(shù)據(jù)敲進(jìn)去又或者是數(shù)值體系調(diào)整要在整個項(xiàng)目里批量替換字段。這種操作重復(fù)、低效還特別容易漏改、錯改。我最早被這個問題卡住是在做一套卡牌游戲的數(shù)值配置時(shí)三百多個SkillData資產(chǎn)需要按新公式重算并統(tǒng)一更新。手動去改折騰了兩天還沒改完后來花了半天寫了個編輯器腳本把這件事變成了“一鍵操作”。今天就把這套思路和具體實(shí)現(xiàn)完整拆開講一講。這里涉及的核心就是Unity編輯器腳本和ScriptableObject的自動化操作適合所有覺得Inspector點(diǎn)來點(diǎn)去效率太低、想用代碼管資產(chǎn)的開發(fā)者參考。1. 整體設(shè)計(jì)與思路拆解1.1 自動化腳本到底要解決什么問題先說清楚編輯器腳本不是用來替代策劃、程序手填配置的它解決的是“批量、規(guī)律、可重復(fù)”的操作。比如新建一批資產(chǎn)字段取值有固定規(guī)則比如從表格轉(zhuǎn)換成配置比如全局替換某個枚舉值再比如把A資產(chǎn)的引用統(tǒng)一掛到B資產(chǎn)上。這些事如果靠手點(diǎn)不僅慢而且人眼很容易漏掉一個字段、點(diǎn)錯一個下拉框。腳本的好處是同樣的邏輯執(zhí)行一百次和一萬次結(jié)果完全一致跑完還能自動打印日志告訴你哪些資產(chǎn)被改過、哪些字段異常。ScriptableObject之所以適合被自動化操作是因?yàn)樗举|(zhì)上就是“序列化在磁盤上的一個對象實(shí)例”。它和Prefab、Scene一樣Unity提供了完整的編輯器API來讀取和修改它。只要你理解了這些API就能在腳本里對任意數(shù)量的資產(chǎn)做增刪改查甚至比手寫JSON配置還順手。1.2 為什么選擇Editor腳本而不是運(yùn)行時(shí)腳本很多人會問我能不能在游戲運(yùn)行時(shí)用代碼改ScriptableObject然后保存下來答案是運(yùn)行時(shí)可以改但不能直接持久化到工程的資產(chǎn)文件resources、addressables之外。因?yàn)檫\(yùn)行時(shí)的Application.persistenceDataPath和工程里的Assets目錄是兩個世界。運(yùn)行時(shí)保存需要自己寫序列化邏輯比如轉(zhuǎn)成JSON寫到本地麻煩且不穩(wěn)定。而Editor腳本運(yùn)行在Unity編輯器的進(jìn)程里可以直接調(diào)用AssetDatabase、SerializedObject、EditorUtility等編輯器專屬API這些API設(shè)計(jì)的初衷就是讓你安全操作項(xiàng)目資產(chǎn)。換句話說Editor腳本是“開發(fā)期工具”運(yùn)行時(shí)腳本是“游戲玩法”。我們要做的自動化操作本質(zhì)上屬于開發(fā)期工具所以應(yīng)該用Editor腳本實(shí)現(xiàn)。它在Unity里被放在Assets/Editor文件夾下或者任意文件夾下的Editor子目錄里編譯時(shí)會自動進(jìn)入Editor程序集不會被打進(jìn)游戲包。1.3 一個通用自動化工具的核心結(jié)構(gòu)無論自動化腳本要做多少件事核心結(jié)構(gòu)基本固定先找到目標(biāo)資產(chǎn)然后加載或創(chuàng)建對象接著修改數(shù)據(jù)最后保存并刷新。用代碼來概括就是這個流程定位用AssetDatabase.FindAssets或者AssetDatabase.LoadAllAssetsAtPath把目標(biāo)ScriptableObject的路徑或GUID找出來。加載用AssetDatabase.LoadAssetAtPath ()拿到具體的對象實(shí)例。修改通過SerializedObject和SerializedProperty來改字段或者直接改對象屬性后再調(diào)用EditorUtility.SetDirty標(biāo)記。保存用AssetDatabase.SaveAssets()把內(nèi)存里的修改寫回磁盤必要時(shí)配合AssetDatabase.Refresh()刷新資源數(shù)據(jù)庫。我建議把每一步都封裝成獨(dú)立函數(shù)因?yàn)椤罢?、改、存”這三個動作在不同的自動化需求里都會重復(fù)用到。后面我會給出一個可以直接抄的封裝類。2. 核心細(xì)節(jié)解析與實(shí)操要點(diǎn)2.1 ScriptableObject的序列化機(jī)制為什么不能只new一個對象要自動化操作ScriptableObject必須先理解它是怎么被序列化的。當(dāng)你寫了一個繼承ScriptableObject的類并通過CreateAssetMenu在Assets里創(chuàng)建一個資產(chǎn)時(shí)Unity會把該對象的公共字段、[SerializeField]私有字段、甚至一些屬性都序列化到.asset文件里。這份文件本質(zhì)是YAML文本除非你開了Binary Serialization模式里面記錄了對象的數(shù)據(jù)和內(nèi)部引用。一個很重要的點(diǎn)是ScriptableObject并不是“場景里的對象”而是“資產(chǎn)”。所以我們不能用new來創(chuàng)建它應(yīng)該用ScriptableObject.CreateInstance ()來創(chuàng)建內(nèi)存實(shí)例再用AssetDatabase.CreateAsset把它落到磁盤上。直接用newUnity不會把它當(dāng)作可序列化資產(chǎn)規(guī)范地處理后面保存和撤銷都可能出問題。理解了這一點(diǎn)你就知道為什么有人直接寫target.damage 100然后發(fā)現(xiàn)沒保存或者保存后撤銷無效——因?yàn)樗麄儧]有走序列化系統(tǒng)的流程尤其是沒有標(biāo)記“臟”。2.2 編輯器腳本里操作資產(chǎn)的正規(guī)姿勢SerializedObject與SerializedProperty在Inspector上Unity編輯框之所以能顯示并修改ScriptableObject的屬性底層就是通過SerializedObject包裝了對象再通過SerializedProperty逐字段訪問。我們寫自動化腳本時(shí)最好也沿用這套方式而不是直接改對象字段原因有三個直接改字段時(shí)Unity不會自動識別這次修改需要手動SetDirty而且無法產(chǎn)生正確的Undo記錄。用SerializedObject的ApplyModifiedProperties會自動把改動同步回對象并標(biāo)記臟。SerializedProperty能幫你處理數(shù)組、嵌套類型、枚舉、引用等復(fù)雜結(jié)構(gòu)直接用對象字段反而容易寫錯類型轉(zhuǎn)換。用SerializedObject時(shí)你可以通過property.serializedObject.targetObject拿到底層對象在循環(huán)里統(tǒng)一處理很舒服。舉個例子修改一個名為damage的float字段SerializedObject so new SerializedObject(skillData); SerializedProperty damage so.FindProperty(damage); damage.floatValue 100; so.ApplyModifiedProperties();這段代碼看起來比直接寫skillData.damage 100多但它保證了修改能進(jìn)入U(xiǎn)nity的撤銷棧也能讓Inspector刷新。對于那些“改完發(fā)現(xiàn)沒保存”的詭異問題多半就是繞開了這套流程。2.3 標(biāo)記臟、保存、撤銷自動化操作的三姐妹在Editor腳本里三個API最容易搞混EditorUtility.SetDirty(target)把目標(biāo)對象標(biāo)記為“已修改”讓Unity在保存場景或退出時(shí)提示保存也會讓資源數(shù)據(jù)庫認(rèn)為它需要被寫回。AssetDatabase.SaveAssets()把所有標(biāo)記臟的資源真正寫入磁盤文件。Undo.RecordObject(target, operation)記錄對象修改前的狀態(tài)之后按CtrlZ可以撤銷到操作前。這三個API不是必須同時(shí)出現(xiàn)但要根據(jù)場景選對。比如你用AssetDatabase.CreateAsset創(chuàng)建了新資產(chǎn)新資產(chǎn)已經(jīng)自然進(jìn)入資源數(shù)據(jù)庫不需要SetDirty但創(chuàng)建后需要SaveAssets來確保文件落地。再比如你用SerializedObject修改已有資產(chǎn)ApplyModifiedProperties內(nèi)部已經(jīng)調(diào)用了SetDirty你還是要SaveAssets才能落盤同時(shí)如果想支持撤銷最好在修改前調(diào)用Undo.RecordObject或者在創(chuàng)建對象后調(diào)用Undo.RegisterCreatedObjectUndo。我踩過一個坑在批量循環(huán)里每改一個字段就SaveAssets一次導(dǎo)致幾百個資產(chǎn)操作卡得要死。正確做法是先批量修改記錄Undo全部改完只調(diào)一次AssetDatabase.SaveAssets配合AssetDatabase.Refresh()刷新。具體的優(yōu)化后面會細(xì)講。2.4 批量操作中的資產(chǎn)導(dǎo)入與刷新控制當(dāng)你批量生成或修改大量.asset文件時(shí)Unity資源數(shù)據(jù)庫會不停地掃描文件變化尤其是你用了AssetDatabase.CreateAsset或SaveAssets之后可能會觸發(fā)導(dǎo)入器重新導(dǎo)入資源。這個導(dǎo)入過程會阻塞主線程一百個資產(chǎn)還好跑到一千個以上文件系統(tǒng)監(jiān)聽和導(dǎo)入管線很容易把編輯器卡到看起來像死機(jī)。所以Unity提供了兩個方法AssetDatabase.StartAssetEditing()和AssetDatabase.StopAssetEditing()。在Start和Stop之間對資產(chǎn)進(jìn)行批量增刪改會讓Unity暫停自動導(dǎo)入直到StopAssetEditing時(shí)才一次性刷新導(dǎo)入。這樣能大幅縮短時(shí)間也能避免“改到一半被導(dǎo)入打斷了引用”的問題。一個標(biāo)準(zhǔn)的批量操作外殼長這樣AssetDatabase.StartAssetEditing(); try { // 批量創(chuàng)建或修改資產(chǎn) } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh();不要在try里漏了StopAssetEditing否則編輯器會一直處于暫停導(dǎo)出的狀態(tài)后續(xù)所有資源操作都變得詭異。我一般寫完之后還會加一個EditorUtility.DisplayProgressBar來做進(jìn)度條讓長時(shí)間批量操作有反饋。3. 實(shí)操過程與核心環(huán)節(jié)實(shí)現(xiàn)3.1 場景一批量創(chuàng)建并填充ScriptableObject資產(chǎn)我們先從最簡單的場景說起需要一次性創(chuàng)建50個ItemData配置資產(chǎn)每個資產(chǎn)包含id、名稱、數(shù)值等字段。直接手點(diǎn)CreateAssetMenu再填數(shù)據(jù)效率極低。下面腳本會在Assets/Items下按編號生成資產(chǎn)并自動填好默認(rèn)值。假設(shè)資產(chǎn)類是[CreateAssetMenu(fileName ItemData, menuName Game/ItemData)] public class ItemData : ScriptableObject { public int id; public string itemName; public float weight; public int maxStack; }批量創(chuàng)建的核心代碼如下using System.IO; using UnityEditor; using UnityEngine; public static class ItemDataBatchCreator { [MenuItem(Tools/Item Data/Batch Create 50 Items)] public static void CreateItems() { string folderPath Assets/Items; if (!Directory.Exists(folderPath)) { Directory.CreateDirectory(folderPath); AssetDatabase.Refresh(); } AssetDatabase.StartAssetEditing(); try { for (int i 1; i 50; i) { ItemData item ScriptableObject.CreateInstanceItemData(); item.id i; item.itemName $Item_{i:000}; item.weight Random.Range(1f, 10f); item.maxStack 99; string path ${folderPath}/Item_{i:000}.asset; AssetDatabase.CreateAsset(item, path); } } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); Debug.Log(已完成50個ItemData資產(chǎn)的批量創(chuàng)建); } }注意幾個細(xì)節(jié)創(chuàng)建前要確保目標(biāo)目錄存在否則CreateAsset會報(bào)“Directory not found”。StartAssetEditing和StopAssetEditing包住循環(huán)避免50次自動導(dǎo)入。CreateAsset本身就會讓新資產(chǎn)進(jìn)入數(shù)據(jù)庫所以不需要SetDirty。foreach循環(huán)里用$“Item_{i:000}”這樣的格式化字符串避免數(shù)字排序變成1、10、2這種亂序。如果你想在生成后順便做一些計(jì)算比如把weight按id縮放可以在CreateAsset之前直接改字段然后用AssetDatabase.SaveAssets統(tǒng)一保存。這種純新建場景比較直接。3.2 場景二批量修改已有資產(chǎn)中的數(shù)值或引用重點(diǎn)來了。我們經(jīng)常需要對已有的一批資產(chǎn)做規(guī)律性修改比如“所有武器類SkillData的傷害提升15%”。如果只靠手改容易漏。腳本的做法是用AssetDatabase.FindAssets(t:SkillData)找到所有SkillData資產(chǎn)路徑逐個加載再通過SerializedObject修改字段。下面是一段可以直接改成自己字段名的示例using UnityEditor; using UnityEngine; public static class SkillDataUpdater { [MenuItem(Tools/Skill Data/Batch Increase Damage 15%)] public static void IncreaseAllDamage() { string[] guids AssetDatabase.FindAssets(t:SkillData); if (guids.Length 0) { Debug.LogWarning(當(dāng)前項(xiàng)目沒有找到任何SkillData資產(chǎn)); return; } AssetDatabase.StartAssetEditing(); try { foreach (string guid in guids) { string path AssetDatabase.GUIDToAssetPath(guid); SkillData skill AssetDatabase.LoadAssetAtPathSkillData(path); if (skill null) continue; Undo.RecordObject(skill, Increase Damage 15%); SerializedObject so new SerializedObject(skill); SerializedProperty damage so.FindProperty(damage); if (damage ! null) { damage.floatValue * 1.15f; so.ApplyModifiedProperties(); } else { Debug.LogWarning(${path} 里沒有找到damage字段跳過); } } } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); Debug.Log($已批量調(diào)整 {guids.Length} 個SkillData的damage); } }這里的關(guān)鍵點(diǎn)是Undo.RecordObject要放在SerializedObject修改之前而且要放在對象加載之后。這樣每個資產(chǎn)都會在撤銷棧中留下記錄。如果你不想太支持撤銷也可以省略但我的習(xí)慣是加上畢竟誤操作了還能一鍵回滾。FindAssets的查找規(guī)則是t:SkillData它會按類型全項(xiàng)目搜索包括AssetBundle等目錄。如果你只想搜某個子目錄可以把路徑傳進(jìn)FindAssets的第二個參數(shù)比如AssetDatabase.FindAssets(t:SkillData, new[] { Assets/SkillData })。3.3 場景三從外部數(shù)據(jù)CSV導(dǎo)入生成配置資產(chǎn)自動化操作ScriptableObject最有價(jià)值的場景就是對接策劃配置表。策劃通常習(xí)慣用Excel或CSV維護(hù)數(shù)值導(dǎo)成CSV后我們寫個腳本把CSV的每一行變成對應(yīng)的ScriptableObject資產(chǎn)省去手動錄入還能順便做一層校驗(yàn)。假設(shè)CSV內(nèi)容格式是id,name,damage,armor,description 1,火球術(shù),100,0,范圍型火屬性傷害 2,冰霜新星,80,5,范圍型冰屬性控制 3,暴風(fēng)雪,120,10,持續(xù)AoE減速對應(yīng)的SkillData類[CreateAssetMenu(fileName SkillData, menuName Game/SkillData)] public class SkillData : ScriptableObject { public int id; public string skillName; public float damage; public int armor; [TextArea] public string description; }導(dǎo)入腳本的核心函數(shù)using System.IO; using UnityEditor; using UnityEngine; public static class SkillCsvImporter { [MenuItem(Tools/Skill Data/Import From CSV)] public static void ImportFromCsv() { string csvPath EditorUtility.OpenFilePanel(選擇技能CSV, Application.dataPath, csv); if (string.IsNullOrEmpty(csvPath)) return; string[] lines File.ReadAllLines(csvPath); if (lines.Length 2) { Debug.LogError(CSV內(nèi)容為空或只有表頭); return; } string outputFolder Assets/Skills; if (!Directory.Exists(outputFolder)) { Directory.CreateDirectory(outputFolder); AssetDatabase.Refresh(); } AssetDatabase.StartAssetEditing(); try { for (int i 1; i lines.Length; i) { string line lines[i]; if (string.IsNullOrWhiteSpace(line)) continue; string[] cols CSVLineSplit(line); if (cols.Length 5) { Debug.LogWarning($第{i 1}行列數(shù)不足已跳過: {line}); continue; } SkillData skill ScriptableObject.CreateInstanceSkillData(); skill.id int.Parse(cols[0].Trim()); skill.skillName cols[1].Trim(); skill.damage float.Parse(cols[2].Trim()); skill.armor int.Parse(cols[3].Trim()); skill.description cols[4].Trim(); string path ${outputFolder}/{skill.skillName}.asset; AssetDatabase.CreateAsset(skill, path); } } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); Debug.Log(CSV導(dǎo)入完成); } private static string[] CSVLineSplit(string line) { // 做簡單分割這里不處理引號內(nèi)逗號的情況足夠應(yīng)付絕大多數(shù)簡單配置表 return line.Split(,); } }CSV解析這里我故意簡化了只按逗號分割。如果策劃導(dǎo)出的CSV里帶雙引號包裹的字段比如description里含英文逗號簡單Split會出錯。實(shí)際項(xiàng)目里最好用現(xiàn)成解析庫或者自己處理引號匹配。不過對絕大多數(shù)內(nèi)部配置表這種簡單切割夠用。還有一個注意事項(xiàng)如果CSV里同一行對應(yīng)的資產(chǎn)已經(jīng)存在直接CreateAsset會報(bào)錯。所以“導(dǎo)入前先刪除舊資產(chǎn)”和“更新已有資產(chǎn)”是兩種常見策略。我建議在導(dǎo)入腳本開頭加一個選項(xiàng)是否清空輸出目錄后再導(dǎo)入這樣能避免重復(fù)創(chuàng)建沖突。3.4 場景四生成資產(chǎn)時(shí)自動校驗(yàn)引用生成完資產(chǎn)后很有必要做一次自動校驗(yàn)。比如SkillData里有下一級技能等級配置引用了一個LevelData資產(chǎn)或者裝備數(shù)據(jù)引用了圖標(biāo)Sprite。手填引用很容易填錯腳本可以在批量操作后掃描所有資產(chǎn)把缺引用、枚舉值超出范圍等異常全部打印出來。下面是一個通用的校驗(yàn)?zāi)_本骨架using UnityEditor; using UnityEngine; public static class ScriptableObjectValidator { [MenuItem(Tools/Validate All ScriptableObjects)] public static void ValidateAll() { string[] guids AssetDatabase.FindAssets(t:SkillData); int errorCount 0; foreach (string guid in guids) { string path AssetDatabase.GUIDToAssetPath(guid); SkillData skill AssetDatabase.LoadAssetAtPathSkillData(path); if (skill null) continue; if (skill.damage 0) { Debug.LogError($[校驗(yàn)失敗] {path} 的damage為負(fù)數(shù): {skill.damage}); errorCount; } if (skill.icon null) { Debug.LogError($[校驗(yàn)失敗] {path} 缺少圖標(biāo)引用); errorCount; } if (skill.id 0) { Debug.LogError($[校驗(yàn)失敗] {path} 的id非法: {skill.id}); errorCount; } } if (errorCount 0) { Debug.Log(所有SkillData資產(chǎn)校驗(yàn)通過); } else { Debug.LogError($共發(fā)現(xiàn) {errorCount} 個校驗(yàn)錯誤請查看日志); } } }這類校驗(yàn)?zāi)_本不一定要手動運(yùn)行可以結(jié)合AssetPostprocessor在資產(chǎn)導(dǎo)入后自動校驗(yàn)。但注意AssetPostprocessor回調(diào)不能太耗時(shí)否則每個資產(chǎn)導(dǎo)入都會卡。我更喜歡把“校驗(yàn)”和“自動化操作”分開自動化操作跑完之后手動觸發(fā)校驗(yàn)或者做成菜單項(xiàng)統(tǒng)一跑一遍。3.5 把自動化腳本掛到菜單、快捷鍵和右鍵菜單腳本寫好了如果每次都要去Assets/Editor目錄里點(diǎn)開腳本才能執(zhí)行那自動化程度還不夠。最好給它一個菜單入口用[MenuItem]特性掛在頂部菜單欄甚至可以注冊快捷鍵。比如[MenuItem(Tools/Item Data/Batch Create 50 Items %#i)] public static void CreateItems() { ... }這里的%#i代表CtrlShiftImacOS上是CmdShiftI。當(dāng)項(xiàng)目里有很多工具腳本時(shí)建議統(tǒng)一放到“Tools/項(xiàng)目名/功能名”這個路徑下避免菜單散亂。如果你想在Project窗口里右鍵某個文件夾時(shí)直接對這個文件夾下的所有資產(chǎn)批量操作可以這樣[MenuItem(Assets/Batch Process ScriptableObjects, false, 30)] public static void BatchProcessFromFolder() { // 拿到當(dāng)前選中文件夾路徑 string folderPath AssetDatabase.GetAssetPath(Selection.activeObject); string[] guids AssetDatabase.FindAssets(t:SkillData, new[] { folderPath }); // 后續(xù)處理... }這里用Selection.activeObject獲取當(dāng)前選中資源然后FindAssets限定搜索目錄。右鍵菜單的路徑前綴必須是“Assets/”數(shù)字是菜單排序數(shù)字越小越靠前。這種方式對美術(shù)、策劃同事來說非常友好他們會用右鍵菜單一鍵處理自己目錄下的資產(chǎn)而不用打開命令行或編輯器窗口。4. 常見問題與排查技巧實(shí)錄4.1 修改后磁盤上不生效為什么asset文件還是舊數(shù)據(jù)這個問題新人遇到得最多。原因幾乎都是沒有調(diào)用AssetDatabase.SaveAssets()或者調(diào)用時(shí)機(jī)不對。SaveAssets只把“臟”的資產(chǎn)寫入磁盤而“臟”的概念來自對象的變更是否被Unity識別。如果你用SerializedObject.ApplyModifiedPropertiesUnity會識別如果你直接改對象字段但沒有調(diào)用EditorUtility.SetDirtyUnity會認(rèn)為這個資產(chǎn)沒變化。另外在Unity 2018及以上版本中某些情況下退出編輯器時(shí)才會自動保存臟資產(chǎn)所以你會看到Inspector里改了、日志也沒報(bào)錯但磁盤文件沒變。排查思路是先確認(rèn)有沒有綠色“臟”標(biāo)記或者改完代碼里立即調(diào)用SaveAssets。一個更隱蔽的坑AssetDatabase.SaveAssets只保存資源數(shù)據(jù)庫不會保存場景。如果你修改的是場景里的ScriptableObject實(shí)例像掛在場景物體上的數(shù)據(jù)應(yīng)該使用EditorSceneManager.MarkSceneDirty和SaveScene。這個要看你的操作對象是資產(chǎn)還是場景對象別搞混。4.2 撤銷失靈按CtrlZ沒有回到修改前Undo記錄生效有幾個前提必須在修改發(fā)生前調(diào)用Undo.RecordObject。修改的目標(biāo)對象必須是一個實(shí)例而且之后發(fā)生的修改應(yīng)發(fā)生在主線程。如果你用SerializedObject修改字段Unity會自己維護(hù)部分撤銷信息但最好仍然在修改前RecordObject一次這樣整塊操作可以作為一個撤銷步驟。批量操作中如果每一條循環(huán)都RecordObject且用的是同一個操作名Unity會把這些步驟合并成一個撤銷組這個行為比較直覺。如果你的撤銷想要每一個資產(chǎn)都是獨(dú)立步驟那就得給每個循環(huán)用不同操作名但我個人覺得合并成一個步驟更好用。還有一點(diǎn)如果你創(chuàng)建了新資產(chǎn)并調(diào)用了AssetDatabase.CreateAsset撤銷這個創(chuàng)建動作需要用Undo.RegisterCreatedObjectUndo(asset, Create asset)。否則你按撤銷時(shí)新建的資產(chǎn)不會消失這會讓自動化腳本的“可逆性”大打折扣。4.3 批量修改導(dǎo)致引用丟失GUID漂移的坑ScriptableObject之間經(jīng)?；ハ嘁帽热鏢killData引用了另一個BuffData資產(chǎn)。如果你在自動化腳本里隨手new了一個SkillData或者用AssetDatabase.CreateAsset創(chuàng)建新的替代舊資產(chǎn)而沒有保持原有GUID那么其他資產(chǎn)對它的引用就會斷掉。因?yàn)閁nity的引用是靠GUID定位的不是靠路徑。一個常見錯誤是為了“更新”某個資產(chǎn)把舊的刪了再建新的這樣引用全斷。正確做法是盡量在同一資產(chǎn)上修改內(nèi)部字段而不是刪除重建。如果確實(shí)需要重建資產(chǎn)那重建后要重新掛引用或者用AssetDatabase.TryGetGUIDAndLocalFileIdentifier找回GUID再手動修復(fù)引用。比較穩(wěn)妥的方案是批量修改前先備份原來的.asset文件或者在內(nèi)存里保留原始對象的引用重建資產(chǎn)后用SerializedObject恢復(fù)引用。不過最省事的還是“修改已有資產(chǎn)”模式而不是“刪除重建”模式。4.4 StartAssetEditing的坑忘記Stop會導(dǎo)致編輯器神游我在前面反復(fù)強(qiáng)調(diào)過StartAssetEditing和StopAssetEditing要成對出現(xiàn)因?yàn)槿绻型痉祷鼗驋伋霎惓]有調(diào)用StopAssetEditingUnity會一直認(rèn)為你在編輯資源導(dǎo)致后續(xù)AssetDatabase.CreateAsset、AssetDatabase.SaveAssets等操作變得非常慢甚至不生效。最安全的方式是try/finallyAssetDatabase.StartAssetEditing(); try { // 批量操作 } finally { AssetDatabase.StopAssetEditing(); }有些情況下編輯器還會提醒你“Asset editing is still in progress”這時(shí)候重啟編輯器也可能無效得在代碼里手動調(diào)用一次AssetDatabase.StopAssetEditing()才能恢復(fù)。我在開發(fā)工具時(shí)會專門準(zhǔn)備一個Debug菜單項(xiàng)用來強(qiáng)制調(diào)用StopAssetEditing防止自己忘了配對。4.5 腳本編譯報(bào)錯與API差異Unity編輯器腳本依賴的API在不同版本有差異特別是Unity 2019和2022有些Editor API改了簽名。遇到報(bào)錯時(shí)先去查你當(dāng)前版本的Unity文檔不要拿著老教程直接抄。常見問題包括AssetDatabase.LoadAssetAtPath ()從Unity 2017以后才支持泛型版本老代碼可能返回Object需要手動轉(zhuǎn)類型。SerializedProperty上找數(shù)組元素的寫法是property.GetArrayElementAtIndex(i)不是property.arraySize[i]。FindAssets(t:ClassName)要求類名和文件名匹配否則會提示找不到類型。CreateAssetMenu的fileName參數(shù)建議預(yù)留空格或占位符不要直接寫死否則創(chuàng)建時(shí)會默認(rèn)按占位符生成。4.6 日志輸出技巧定位批量操作中的異常當(dāng)批量操作處理幾百個資產(chǎn)時(shí)如果某個資產(chǎn)字段不合法整個循環(huán)可能會中斷。我建議在關(guān)鍵步驟加日志并采用“收集錯誤最后統(tǒng)一輸出”的模式而不是遇到第一個錯誤就return。這會讓自動化腳本在項(xiàng)目里更實(shí)用。比如Liststring errors new Liststring(); foreach (var guid in guids) { try { // 操作 } catch (System.Exception e) { errors.Add(${path}: {e.Message}); } } if (errors.Count 0) { Debug.LogError($批量操作完成但有 {errors.Count} 個錯誤:\n{string.Join(\n, errors)}); } else { Debug.Log(批量操作全部成功); }這樣做的好處是即使有個別資產(chǎn)異常其他資產(chǎn)也能繼續(xù)處理而且最后你看到的錯誤日志包含路徑和原因可以直接定位到具體文件。5. 進(jìn)階與架構(gòu)建議5.1 把自動化操作封裝成通用模塊寫多了就會發(fā)現(xiàn)不管是批量創(chuàng)建、批量修改還是CSV導(dǎo)入代碼里都有一塊“找資產(chǎn)、加StartAssetEditing、SaveAssets、Refresh”的模板。我建議把這部分抽成獨(dú)立工具類比如AssetBatchHelper讓具體業(yè)務(wù)腳本只關(guān)心字段怎么填。這樣你的工具包會越來越干凈新需求幾分鐘就能接入。一個簡化的封裝思路public static class AssetBatchHelper { public static T[] LoadAllAssetsT(string searchFolder null) where T : ScriptableObject { string[] guids string.IsNullOrEmpty(searchFolder) ? AssetDatabase.FindAssets($t:{typeof(T).Name}) : AssetDatabase.FindAssets($t:{typeof(T).Name}, new[] { searchFolder }); T[] result new T[guids.Length]; for (int i 0; i guids.Length; i) { string path AssetDatabase.GUIDToAssetPath(guids[i]); result[i] AssetDatabase.LoadAssetAtPathT(path); } return result; } public static void BatchEdit(Action editAction) { AssetDatabase.StartAssetEditing(); try { editAction(); } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); } }然后在具體業(yè)務(wù)里這樣調(diào)用private static void UpdateAll() { var items AssetBatchHelper.LoadAllAssetsItemData(Assets/Items); AssetBatchHelper.BatchEdit(() { foreach (var item in items) { Undo.RecordObject(item, Update); item.maxStack 999; EditorUtility.SetDirty(item); } }); }這里直接改字段并SetDirty也是一個可行模式尤其是當(dāng)字段不需要Inspector刷新、且你已經(jīng)習(xí)慣了直接操作對象時(shí)。不過要注意直接改字段時(shí)不支持SerializedProperty所以撤銷需要使用Undo.RecordObject。我自己的習(xí)慣是簡單字段直接改SetDirty涉及數(shù)組/嵌套引用時(shí)用SerializedObject這樣可以減少很多類型轉(zhuǎn)換的麻煩。5.2 給自動化工具加一個可視化窗口命令行式菜單雖然方便編程的人但策劃和非技術(shù)同事用起來不直觀。這時(shí)候可以在EditorWindow里做一個小工具面板用按鈕和輸入框把操作暴露出來。比如一個窗口里有三個按鈕“批量創(chuàng)建”“批量修改”“CSV導(dǎo)入”還有一個文本框顯示日志。渲染邏輯不復(fù)雜主要是繼承EditorWindow在OnGUI里用GUILayout畫控件然后綁定MenuItem打開窗口。這種方式能把工具的門檻降到“點(diǎn)按鈕”級別也能避免操作人員手誤運(yùn)行了危險(xiǎn)命令。我往往會加一個確認(rèn)彈窗if (!EditorUtility.DisplayDialog(確認(rèn), $即將修改 {count} 個資產(chǎn), 是否繼續(xù)?, 確認(rèn), 取消)) { return; }這招在自動化腳本里特別重要因?yàn)樗茉谀阏`點(diǎn)菜單或沒拿準(zhǔn)數(shù)據(jù)格式時(shí)救你一命。5.3 接入AssetPostprocessor和CI如果你對自動化要求更高可以把它嵌到Unity的導(dǎo)入管線里。比如寫一個AssetPostprocessor在onPostprocessAllAssets回調(diào)里檢測到某個目錄新增了CSV文件就自動執(zhí)行導(dǎo)入生成ScriptableObject。不過這要謹(jǐn)慎因?yàn)閷?dǎo)入管線是每次進(jìn)編輯器都可能觸發(fā)處理不當(dāng)會讓編輯器卡頓。更保險(xiǎn)的做法是在CI持續(xù)集成流程中跑編輯器腳本。比如在Jenkins或GitHub Actions里執(zhí)行Unity的批處理命令調(diào)用Unity.exe -batchmode -projectPath xxx -executeMethod YourTool.BatchImport -quit讓導(dǎo)入腳本自動生成全部配置資產(chǎn)再導(dǎo)出為AssetBundle。這樣做能保證每次構(gòu)建前的配置都是最新的也能在版本控制里看到資產(chǎn)更新。寫批處理調(diào)用時(shí)注意純批處理模式?jīng)]有UIEditorUtility.DisplayDialog這類需要用戶交互的API不能直接調(diào)用要提前判斷Application.isBatchMode跳過。5.4 把數(shù)據(jù)驅(qū)動與自動化操作結(jié)合ScriptableObject的自動化操作不只是“改數(shù)據(jù)”還可以和數(shù)據(jù)驅(qū)動工具聯(lián)動。比如你可以寫一個工具根據(jù)命名規(guī)則自動為每個角色生成一組技能配置資產(chǎn)再寫一個工具統(tǒng)計(jì)所有技能配置的強(qiáng)度曲線并輸出報(bào)告。這類工具其實(shí)都在做同一件事把本來要靠人維護(hù)的配置變成由規(guī)則和代碼維護(hù)。數(shù)據(jù)驅(qū)動的好處是當(dāng)策劃調(diào)整數(shù)值公式時(shí)你不需要改幾十個資產(chǎn)只需要改工具里的公式然后一鍵重跑。久而久之配置的準(zhǔn)確性、一致性會顯著提升。寫在最后的個人經(jīng)驗(yàn)回想起來我用編輯器腳本批量操作ScriptableObject的最大心得是永遠(yuǎn)先把“找資產(chǎn)”和“改資產(chǎn)”分開寫。找資產(chǎn)的方式主要靠FindAssets、GUID或路徑改資產(chǎn)的方式要么是SerializedObject要么是直接SetDirty。只要這兩個概念清晰剩下的就是組合。另一個很實(shí)用的小技巧是在批量操作前先在內(nèi)存里打印一份《將要修改的資產(chǎn)清單》確認(rèn)無誤再執(zhí)行尤其是要改幾十上百個資產(chǎn)的時(shí)候。腳本不是用來省一次確認(rèn)的是用來減少重復(fù)勞動和人為失誤的。我后來做項(xiàng)目凡是涉及“改配置”的需求第一反應(yīng)都是寫個幾行代碼的菜單項(xiàng)而不是打開Inspector一個個點(diǎn)。這個習(xí)慣幫我省了不知多少時(shí)間。 Unity編輯器腳本批量操作ScriptableObject：從手動配置到一鍵自動化
在Unity項(xiàng)目里ScriptableObject大概是除了Prefab和Scene之外最常用來存配置的東西了。但相信很多人都有過這種體驗(yàn)需求一改幾十個配置資產(chǎn)要一個一個點(diǎn)開改策劃給了一張表你要手動在Inspector里把幾十條數(shù)據(jù)敲進(jìn)去又或者是數(shù)值體系調(diào)整要在整個項(xiàng)目里批量替換字段。這種操作重復(fù)、低效還特別容易漏改、錯改。我最早被這個問題卡住是在做一套卡牌游戲的數(shù)值配置時(shí)三百多個SkillData資產(chǎn)需要按新公式重算并統(tǒng)一更新。手動去改折騰了兩天還沒改完后來花了半天寫了個編輯器腳本把這件事變成了“一鍵操作”。今天就把這套思路和具體實(shí)現(xiàn)完整拆開講一講。這里涉及的核心就是Unity編輯器腳本和ScriptableObject的自動化操作適合所有覺得Inspector點(diǎn)來點(diǎn)去效率太低、想用代碼管資產(chǎn)的開發(fā)者參考。1. 整體設(shè)計(jì)與思路拆解1.1 自動化腳本到底要解決什么問題先說清楚編輯器腳本不是用來替代策劃、程序手填配置的它解決的是“批量、規(guī)律、可重復(fù)”的操作。比如新建一批資產(chǎn)字段取值有固定規(guī)則比如從表格轉(zhuǎn)換成配置比如全局替換某個枚舉值再比如把A資產(chǎn)的引用統(tǒng)一掛到B資產(chǎn)上。這些事如果靠手點(diǎn)不僅慢而且人眼很容易漏掉一個字段、點(diǎn)錯一個下拉框。腳本的好處是同樣的邏輯執(zhí)行一百次和一萬次結(jié)果完全一致跑完還能自動打印日志告訴你哪些資產(chǎn)被改過、哪些字段異常。ScriptableObject之所以適合被自動化操作是因?yàn)樗举|(zhì)上就是“序列化在磁盤上的一個對象實(shí)例”。它和Prefab、Scene一樣Unity提供了完整的編輯器API來讀取和修改它。只要你理解了這些API就能在腳本里對任意數(shù)量的資產(chǎn)做增刪改查甚至比手寫JSON配置還順手。1.2 為什么選擇Editor腳本而不是運(yùn)行時(shí)腳本很多人會問我能不能在游戲運(yùn)行時(shí)用代碼改ScriptableObject然后保存下來答案是運(yùn)行時(shí)可以改但不能直接持久化到工程的資產(chǎn)文件resources、addressables之外。因?yàn)檫\(yùn)行時(shí)的Application.persistenceDataPath和工程里的Assets目錄是兩個世界。運(yùn)行時(shí)保存需要自己寫序列化邏輯比如轉(zhuǎn)成JSON寫到本地麻煩且不穩(wěn)定。而Editor腳本運(yùn)行在Unity編輯器的進(jìn)程里可以直接調(diào)用AssetDatabase、SerializedObject、EditorUtility等編輯器專屬API這些API設(shè)計(jì)的初衷就是讓你安全操作項(xiàng)目資產(chǎn)。換句話說Editor腳本是“開發(fā)期工具”運(yùn)行時(shí)腳本是“游戲玩法”。我們要做的自動化操作本質(zhì)上屬于開發(fā)期工具所以應(yīng)該用Editor腳本實(shí)現(xiàn)。它在Unity里被放在Assets/Editor文件夾下或者任意文件夾下的Editor子目錄里編譯時(shí)會自動進(jìn)入Editor程序集不會被打進(jìn)游戲包。1.3 一個通用自動化工具的核心結(jié)構(gòu)無論自動化腳本要做多少件事核心結(jié)構(gòu)基本固定先找到目標(biāo)資產(chǎn)然后加載或創(chuàng)建對象接著修改數(shù)據(jù)最后保存并刷新。用代碼來概括就是這個流程定位用AssetDatabase.FindAssets或者AssetDatabase.LoadAllAssetsAtPath把目標(biāo)ScriptableObject的路徑或GUID找出來。加載用AssetDatabase.LoadAssetAtPath ()拿到具體的對象實(shí)例。修改通過SerializedObject和SerializedProperty來改字段或者直接改對象屬性后再調(diào)用EditorUtility.SetDirty標(biāo)記。保存用AssetDatabase.SaveAssets()把內(nèi)存里的修改寫回磁盤必要時(shí)配合AssetDatabase.Refresh()刷新資源數(shù)據(jù)庫。我建議把每一步都封裝成獨(dú)立函數(shù)因?yàn)椤罢?、改、存”這三個動作在不同的自動化需求里都會重復(fù)用到。后面我會給出一個可以直接抄的封裝類。2. 核心細(xì)節(jié)解析與實(shí)操要點(diǎn)2.1 ScriptableObject的序列化機(jī)制為什么不能只new一個對象要自動化操作ScriptableObject必須先理解它是怎么被序列化的。當(dāng)你寫了一個繼承ScriptableObject的類并通過CreateAssetMenu在Assets里創(chuàng)建一個資產(chǎn)時(shí)Unity會把該對象的公共字段、[SerializeField]私有字段、甚至一些屬性都序列化到.asset文件里。這份文件本質(zhì)是YAML文本除非你開了Binary Serialization模式里面記錄了對象的數(shù)據(jù)和內(nèi)部引用。一個很重要的點(diǎn)是ScriptableObject并不是“場景里的對象”而是“資產(chǎn)”。所以我們不能用new來創(chuàng)建它應(yīng)該用ScriptableObject.CreateInstance ()來創(chuàng)建內(nèi)存實(shí)例再用AssetDatabase.CreateAsset把它落到磁盤上。直接用newUnity不會把它當(dāng)作可序列化資產(chǎn)規(guī)范地處理后面保存和撤銷都可能出問題。理解了這一點(diǎn)你就知道為什么有人直接寫target.damage 100然后發(fā)現(xiàn)沒保存或者保存后撤銷無效——因?yàn)樗麄儧]有走序列化系統(tǒng)的流程尤其是沒有標(biāo)記“臟”。2.2 編輯器腳本里操作資產(chǎn)的正規(guī)姿勢SerializedObject與SerializedProperty在Inspector上Unity編輯框之所以能顯示并修改ScriptableObject的屬性底層就是通過SerializedObject包裝了對象再通過SerializedProperty逐字段訪問。我們寫自動化腳本時(shí)最好也沿用這套方式而不是直接改對象字段原因有三個直接改字段時(shí)Unity不會自動識別這次修改需要手動SetDirty而且無法產(chǎn)生正確的Undo記錄。用SerializedObject的ApplyModifiedProperties會自動把改動同步回對象并標(biāo)記臟。SerializedProperty能幫你處理數(shù)組、嵌套類型、枚舉、引用等復(fù)雜結(jié)構(gòu)直接用對象字段反而容易寫錯類型轉(zhuǎn)換。用SerializedObject時(shí)你可以通過property.serializedObject.targetObject拿到底層對象在循環(huán)里統(tǒng)一處理很舒服。舉個例子修改一個名為damage的float字段SerializedObject so new SerializedObject(skillData); SerializedProperty damage so.FindProperty(damage); damage.floatValue 100; so.ApplyModifiedProperties();這段代碼看起來比直接寫skillData.damage 100多但它保證了修改能進(jìn)入U(xiǎn)nity的撤銷棧也能讓Inspector刷新。對于那些“改完發(fā)現(xiàn)沒保存”的詭異問題多半就是繞開了這套流程。2.3 標(biāo)記臟、保存、撤銷自動化操作的三姐妹在Editor腳本里三個API最容易搞混EditorUtility.SetDirty(target)把目標(biāo)對象標(biāo)記為“已修改”讓Unity在保存場景或退出時(shí)提示保存也會讓資源數(shù)據(jù)庫認(rèn)為它需要被寫回。AssetDatabase.SaveAssets()把所有標(biāo)記臟的資源真正寫入磁盤文件。Undo.RecordObject(target, operation)記錄對象修改前的狀態(tài)之后按CtrlZ可以撤銷到操作前。這三個API不是必須同時(shí)出現(xiàn)但要根據(jù)場景選對。比如你用AssetDatabase.CreateAsset創(chuàng)建了新資產(chǎn)新資產(chǎn)已經(jīng)自然進(jìn)入資源數(shù)據(jù)庫不需要SetDirty但創(chuàng)建后需要SaveAssets來確保文件落地。再比如你用SerializedObject修改已有資產(chǎn)ApplyModifiedProperties內(nèi)部已經(jīng)調(diào)用了SetDirty你還是要SaveAssets才能落盤同時(shí)如果想支持撤銷最好在修改前調(diào)用Undo.RecordObject或者在創(chuàng)建對象后調(diào)用Undo.RegisterCreatedObjectUndo。我踩過一個坑在批量循環(huán)里每改一個字段就SaveAssets一次導(dǎo)致幾百個資產(chǎn)操作卡得要死。正確做法是先批量修改記錄Undo全部改完只調(diào)一次AssetDatabase.SaveAssets配合AssetDatabase.Refresh()刷新。具體的優(yōu)化后面會細(xì)講。2.4 批量操作中的資產(chǎn)導(dǎo)入與刷新控制當(dāng)你批量生成或修改大量.asset文件時(shí)Unity資源數(shù)據(jù)庫會不停地掃描文件變化尤其是你用了AssetDatabase.CreateAsset或SaveAssets之后可能會觸發(fā)導(dǎo)入器重新導(dǎo)入資源。這個導(dǎo)入過程會阻塞主線程一百個資產(chǎn)還好跑到一千個以上文件系統(tǒng)監(jiān)聽和導(dǎo)入管線很容易把編輯器卡到看起來像死機(jī)。所以Unity提供了兩個方法AssetDatabase.StartAssetEditing()和AssetDatabase.StopAssetEditing()。在Start和Stop之間對資產(chǎn)進(jìn)行批量增刪改會讓Unity暫停自動導(dǎo)入直到StopAssetEditing時(shí)才一次性刷新導(dǎo)入。這樣能大幅縮短時(shí)間也能避免“改到一半被導(dǎo)入打斷了引用”的問題。一個標(biāo)準(zhǔn)的批量操作外殼長這樣AssetDatabase.StartAssetEditing(); try { // 批量創(chuàng)建或修改資產(chǎn) } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh();不要在try里漏了StopAssetEditing否則編輯器會一直處于暫停導(dǎo)出的狀態(tài)后續(xù)所有資源操作都變得詭異。我一般寫完之后還會加一個EditorUtility.DisplayProgressBar來做進(jìn)度條讓長時(shí)間批量操作有反饋。3. 實(shí)操過程與核心環(huán)節(jié)實(shí)現(xiàn)3.1 場景一批量創(chuàng)建并填充ScriptableObject資產(chǎn)我們先從最簡單的場景說起需要一次性創(chuàng)建50個ItemData配置資產(chǎn)每個資產(chǎn)包含id、名稱、數(shù)值等字段。直接手點(diǎn)CreateAssetMenu再填數(shù)據(jù)效率極低。下面腳本會在Assets/Items下按編號生成資產(chǎn)并自動填好默認(rèn)值。假設(shè)資產(chǎn)類是[CreateAssetMenu(fileName ItemData, menuName Game/ItemData)] public class ItemData : ScriptableObject { public int id; public string itemName; public float weight; public int maxStack; }批量創(chuàng)建的核心代碼如下using System.IO; using UnityEditor; using UnityEngine; public static class ItemDataBatchCreator { [MenuItem(Tools/Item Data/Batch Create 50 Items)] public static void CreateItems() { string folderPath Assets/Items; if (!Directory.Exists(folderPath)) { Directory.CreateDirectory(folderPath); AssetDatabase.Refresh(); } AssetDatabase.StartAssetEditing(); try { for (int i 1; i 50; i) { ItemData item ScriptableObject.CreateInstanceItemData(); item.id i; item.itemName $Item_{i:000}; item.weight Random.Range(1f, 10f); item.maxStack 99; string path ${folderPath}/Item_{i:000}.asset; AssetDatabase.CreateAsset(item, path); } } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); Debug.Log(已完成50個ItemData資產(chǎn)的批量創(chuàng)建); } }注意幾個細(xì)節(jié)創(chuàng)建前要確保目標(biāo)目錄存在否則CreateAsset會報(bào)“Directory not found”。StartAssetEditing和StopAssetEditing包住循環(huán)避免50次自動導(dǎo)入。CreateAsset本身就會讓新資產(chǎn)進(jìn)入數(shù)據(jù)庫所以不需要SetDirty。foreach循環(huán)里用$“Item_{i:000}”這樣的格式化字符串避免數(shù)字排序變成1、10、2這種亂序。如果你想在生成后順便做一些計(jì)算比如把weight按id縮放可以在CreateAsset之前直接改字段然后用AssetDatabase.SaveAssets統(tǒng)一保存。這種純新建場景比較直接。3.2 場景二批量修改已有資產(chǎn)中的數(shù)值或引用重點(diǎn)來了。我們經(jīng)常需要對已有的一批資產(chǎn)做規(guī)律性修改比如“所有武器類SkillData的傷害提升15%”。如果只靠手改容易漏。腳本的做法是用AssetDatabase.FindAssets(t:SkillData)找到所有SkillData資產(chǎn)路徑逐個加載再通過SerializedObject修改字段。下面是一段可以直接改成自己字段名的示例using UnityEditor; using UnityEngine; public static class SkillDataUpdater { [MenuItem(Tools/Skill Data/Batch Increase Damage 15%)] public static void IncreaseAllDamage() { string[] guids AssetDatabase.FindAssets(t:SkillData); if (guids.Length 0) { Debug.LogWarning(當(dāng)前項(xiàng)目沒有找到任何SkillData資產(chǎn)); return; } AssetDatabase.StartAssetEditing(); try { foreach (string guid in guids) { string path AssetDatabase.GUIDToAssetPath(guid); SkillData skill AssetDatabase.LoadAssetAtPathSkillData(path); if (skill null) continue; Undo.RecordObject(skill, Increase Damage 15%); SerializedObject so new SerializedObject(skill); SerializedProperty damage so.FindProperty(damage); if (damage ! null) { damage.floatValue * 1.15f; so.ApplyModifiedProperties(); } else { Debug.LogWarning(${path} 里沒有找到damage字段跳過); } } } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); Debug.Log($已批量調(diào)整 {guids.Length} 個SkillData的damage); } }這里的關(guān)鍵點(diǎn)是Undo.RecordObject要放在SerializedObject修改之前而且要放在對象加載之后。這樣每個資產(chǎn)都會在撤銷棧中留下記錄。如果你不想太支持撤銷也可以省略但我的習(xí)慣是加上畢竟誤操作了還能一鍵回滾。FindAssets的查找規(guī)則是t:SkillData它會按類型全項(xiàng)目搜索包括AssetBundle等目錄。如果你只想搜某個子目錄可以把路徑傳進(jìn)FindAssets的第二個參數(shù)比如AssetDatabase.FindAssets(t:SkillData, new[] { Assets/SkillData })。3.3 場景三從外部數(shù)據(jù)CSV導(dǎo)入生成配置資產(chǎn)自動化操作ScriptableObject最有價(jià)值的場景就是對接策劃配置表。策劃通常習(xí)慣用Excel或CSV維護(hù)數(shù)值導(dǎo)成CSV后我們寫個腳本把CSV的每一行變成對應(yīng)的ScriptableObject資產(chǎn)省去手動錄入還能順便做一層校驗(yàn)。假設(shè)CSV內(nèi)容格式是id,name,damage,armor,description 1,火球術(shù),100,0,范圍型火屬性傷害 2,冰霜新星,80,5,范圍型冰屬性控制 3,暴風(fēng)雪,120,10,持續(xù)AoE減速對應(yīng)的SkillData類[CreateAssetMenu(fileName SkillData, menuName Game/SkillData)] public class SkillData : ScriptableObject { public int id; public string skillName; public float damage; public int armor; [TextArea] public string description; }導(dǎo)入腳本的核心函數(shù)using System.IO; using UnityEditor; using UnityEngine; public static class SkillCsvImporter { [MenuItem(Tools/Skill Data/Import From CSV)] public static void ImportFromCsv() { string csvPath EditorUtility.OpenFilePanel(選擇技能CSV, Application.dataPath, csv); if (string.IsNullOrEmpty(csvPath)) return; string[] lines File.ReadAllLines(csvPath); if (lines.Length 2) { Debug.LogError(CSV內(nèi)容為空或只有表頭); return; } string outputFolder Assets/Skills; if (!Directory.Exists(outputFolder)) { Directory.CreateDirectory(outputFolder); AssetDatabase.Refresh(); } AssetDatabase.StartAssetEditing(); try { for (int i 1; i lines.Length; i) { string line lines[i]; if (string.IsNullOrWhiteSpace(line)) continue; string[] cols CSVLineSplit(line); if (cols.Length 5) { Debug.LogWarning($第{i 1}行列數(shù)不足已跳過: {line}); continue; } SkillData skill ScriptableObject.CreateInstanceSkillData(); skill.id int.Parse(cols[0].Trim()); skill.skillName cols[1].Trim(); skill.damage float.Parse(cols[2].Trim()); skill.armor int.Parse(cols[3].Trim()); skill.description cols[4].Trim(); string path ${outputFolder}/{skill.skillName}.asset; AssetDatabase.CreateAsset(skill, path); } } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); Debug.Log(CSV導(dǎo)入完成); } private static string[] CSVLineSplit(string line) { // 做簡單分割這里不處理引號內(nèi)逗號的情況足夠應(yīng)付絕大多數(shù)簡單配置表 return line.Split(,); } }CSV解析這里我故意簡化了只按逗號分割。如果策劃導(dǎo)出的CSV里帶雙引號包裹的字段比如description里含英文逗號簡單Split會出錯。實(shí)際項(xiàng)目里最好用現(xiàn)成解析庫或者自己處理引號匹配。不過對絕大多數(shù)內(nèi)部配置表這種簡單切割夠用。還有一個注意事項(xiàng)如果CSV里同一行對應(yīng)的資產(chǎn)已經(jīng)存在直接CreateAsset會報(bào)錯。所以“導(dǎo)入前先刪除舊資產(chǎn)”和“更新已有資產(chǎn)”是兩種常見策略。我建議在導(dǎo)入腳本開頭加一個選項(xiàng)是否清空輸出目錄后再導(dǎo)入這樣能避免重復(fù)創(chuàng)建沖突。3.4 場景四生成資產(chǎn)時(shí)自動校驗(yàn)引用生成完資產(chǎn)后很有必要做一次自動校驗(yàn)。比如SkillData里有下一級技能等級配置引用了一個LevelData資產(chǎn)或者裝備數(shù)據(jù)引用了圖標(biāo)Sprite。手填引用很容易填錯腳本可以在批量操作后掃描所有資產(chǎn)把缺引用、枚舉值超出范圍等異常全部打印出來。下面是一個通用的校驗(yàn)?zāi)_本骨架using UnityEditor; using UnityEngine; public static class ScriptableObjectValidator { [MenuItem(Tools/Validate All ScriptableObjects)] public static void ValidateAll() { string[] guids AssetDatabase.FindAssets(t:SkillData); int errorCount 0; foreach (string guid in guids) { string path AssetDatabase.GUIDToAssetPath(guid); SkillData skill AssetDatabase.LoadAssetAtPathSkillData(path); if (skill null) continue; if (skill.damage 0) { Debug.LogError($[校驗(yàn)失敗] {path} 的damage為負(fù)數(shù): {skill.damage}); errorCount; } if (skill.icon null) { Debug.LogError($[校驗(yàn)失敗] {path} 缺少圖標(biāo)引用); errorCount; } if (skill.id 0) { Debug.LogError($[校驗(yàn)失敗] {path} 的id非法: {skill.id}); errorCount; } } if (errorCount 0) { Debug.Log(所有SkillData資產(chǎn)校驗(yàn)通過); } else { Debug.LogError($共發(fā)現(xiàn) {errorCount} 個校驗(yàn)錯誤請查看日志); } } }這類校驗(yàn)?zāi)_本不一定要手動運(yùn)行可以結(jié)合AssetPostprocessor在資產(chǎn)導(dǎo)入后自動校驗(yàn)。但注意AssetPostprocessor回調(diào)不能太耗時(shí)否則每個資產(chǎn)導(dǎo)入都會卡。我更喜歡把“校驗(yàn)”和“自動化操作”分開自動化操作跑完之后手動觸發(fā)校驗(yàn)或者做成菜單項(xiàng)統(tǒng)一跑一遍。3.5 把自動化腳本掛到菜單、快捷鍵和右鍵菜單腳本寫好了如果每次都要去Assets/Editor目錄里點(diǎn)開腳本才能執(zhí)行那自動化程度還不夠。最好給它一個菜單入口用[MenuItem]特性掛在頂部菜單欄甚至可以注冊快捷鍵。比如[MenuItem(Tools/Item Data/Batch Create 50 Items %#i)] public static void CreateItems() { ... }這里的%#i代表CtrlShiftImacOS上是CmdShiftI。當(dāng)項(xiàng)目里有很多工具腳本時(shí)建議統(tǒng)一放到“Tools/項(xiàng)目名/功能名”這個路徑下避免菜單散亂。如果你想在Project窗口里右鍵某個文件夾時(shí)直接對這個文件夾下的所有資產(chǎn)批量操作可以這樣[MenuItem(Assets/Batch Process ScriptableObjects, false, 30)] public static void BatchProcessFromFolder() { // 拿到當(dāng)前選中文件夾路徑 string folderPath AssetDatabase.GetAssetPath(Selection.activeObject); string[] guids AssetDatabase.FindAssets(t:SkillData, new[] { folderPath }); // 后續(xù)處理... }這里用Selection.activeObject獲取當(dāng)前選中資源然后FindAssets限定搜索目錄。右鍵菜單的路徑前綴必須是“Assets/”數(shù)字是菜單排序數(shù)字越小越靠前。這種方式對美術(shù)、策劃同事來說非常友好他們會用右鍵菜單一鍵處理自己目錄下的資產(chǎn)而不用打開命令行或編輯器窗口。4. 常見問題與排查技巧實(shí)錄4.1 修改后磁盤上不生效為什么asset文件還是舊數(shù)據(jù)這個問題新人遇到得最多。原因幾乎都是沒有調(diào)用AssetDatabase.SaveAssets()或者調(diào)用時(shí)機(jī)不對。SaveAssets只把“臟”的資產(chǎn)寫入磁盤而“臟”的概念來自對象的變更是否被Unity識別。如果你用SerializedObject.ApplyModifiedPropertiesUnity會識別如果你直接改對象字段但沒有調(diào)用EditorUtility.SetDirtyUnity會認(rèn)為這個資產(chǎn)沒變化。另外在Unity 2018及以上版本中某些情況下退出編輯器時(shí)才會自動保存臟資產(chǎn)所以你會看到Inspector里改了、日志也沒報(bào)錯但磁盤文件沒變。排查思路是先確認(rèn)有沒有綠色“臟”標(biāo)記或者改完代碼里立即調(diào)用SaveAssets。一個更隱蔽的坑AssetDatabase.SaveAssets只保存資源數(shù)據(jù)庫不會保存場景。如果你修改的是場景里的ScriptableObject實(shí)例像掛在場景物體上的數(shù)據(jù)應(yīng)該使用EditorSceneManager.MarkSceneDirty和SaveScene。這個要看你的操作對象是資產(chǎn)還是場景對象別搞混。4.2 撤銷失靈按CtrlZ沒有回到修改前Undo記錄生效有幾個前提必須在修改發(fā)生前調(diào)用Undo.RecordObject。修改的目標(biāo)對象必須是一個實(shí)例而且之后發(fā)生的修改應(yīng)發(fā)生在主線程。如果你用SerializedObject修改字段Unity會自己維護(hù)部分撤銷信息但最好仍然在修改前RecordObject一次這樣整塊操作可以作為一個撤銷步驟。批量操作中如果每一條循環(huán)都RecordObject且用的是同一個操作名Unity會把這些步驟合并成一個撤銷組這個行為比較直覺。如果你的撤銷想要每一個資產(chǎn)都是獨(dú)立步驟那就得給每個循環(huán)用不同操作名但我個人覺得合并成一個步驟更好用。還有一點(diǎn)如果你創(chuàng)建了新資產(chǎn)并調(diào)用了AssetDatabase.CreateAsset撤銷這個創(chuàng)建動作需要用Undo.RegisterCreatedObjectUndo(asset, Create asset)。否則你按撤銷時(shí)新建的資產(chǎn)不會消失這會讓自動化腳本的“可逆性”大打折扣。4.3 批量修改導(dǎo)致引用丟失GUID漂移的坑ScriptableObject之間經(jīng)?；ハ嘁帽热鏢killData引用了另一個BuffData資產(chǎn)。如果你在自動化腳本里隨手new了一個SkillData或者用AssetDatabase.CreateAsset創(chuàng)建新的替代舊資產(chǎn)而沒有保持原有GUID那么其他資產(chǎn)對它的引用就會斷掉。因?yàn)閁nity的引用是靠GUID定位的不是靠路徑。一個常見錯誤是為了“更新”某個資產(chǎn)把舊的刪了再建新的這樣引用全斷。正確做法是盡量在同一資產(chǎn)上修改內(nèi)部字段而不是刪除重建。如果確實(shí)需要重建資產(chǎn)那重建后要重新掛引用或者用AssetDatabase.TryGetGUIDAndLocalFileIdentifier找回GUID再手動修復(fù)引用。比較穩(wěn)妥的方案是批量修改前先備份原來的.asset文件或者在內(nèi)存里保留原始對象的引用重建資產(chǎn)后用SerializedObject恢復(fù)引用。不過最省事的還是“修改已有資產(chǎn)”模式而不是“刪除重建”模式。4.4 StartAssetEditing的坑忘記Stop會導(dǎo)致編輯器神游我在前面反復(fù)強(qiáng)調(diào)過StartAssetEditing和StopAssetEditing要成對出現(xiàn)因?yàn)槿绻型痉祷鼗驋伋霎惓]有調(diào)用StopAssetEditingUnity會一直認(rèn)為你在編輯資源導(dǎo)致后續(xù)AssetDatabase.CreateAsset、AssetDatabase.SaveAssets等操作變得非常慢甚至不生效。最安全的方式是try/finallyAssetDatabase.StartAssetEditing(); try { // 批量操作 } finally { AssetDatabase.StopAssetEditing(); }有些情況下編輯器還會提醒你“Asset editing is still in progress”這時(shí)候重啟編輯器也可能無效得在代碼里手動調(diào)用一次AssetDatabase.StopAssetEditing()才能恢復(fù)。我在開發(fā)工具時(shí)會專門準(zhǔn)備一個Debug菜單項(xiàng)用來強(qiáng)制調(diào)用StopAssetEditing防止自己忘了配對。4.5 腳本編譯報(bào)錯與API差異Unity編輯器腳本依賴的API在不同版本有差異特別是Unity 2019和2022有些Editor API改了簽名。遇到報(bào)錯時(shí)先去查你當(dāng)前版本的Unity文檔不要拿著老教程直接抄。常見問題包括AssetDatabase.LoadAssetAtPath ()從Unity 2017以后才支持泛型版本老代碼可能返回Object需要手動轉(zhuǎn)類型。SerializedProperty上找數(shù)組元素的寫法是property.GetArrayElementAtIndex(i)不是property.arraySize[i]。FindAssets(t:ClassName)要求類名和文件名匹配否則會提示找不到類型。CreateAssetMenu的fileName參數(shù)建議預(yù)留空格或占位符不要直接寫死否則創(chuàng)建時(shí)會默認(rèn)按占位符生成。4.6 日志輸出技巧定位批量操作中的異常當(dāng)批量操作處理幾百個資產(chǎn)時(shí)如果某個資產(chǎn)字段不合法整個循環(huán)可能會中斷。我建議在關(guān)鍵步驟加日志并采用“收集錯誤最后統(tǒng)一輸出”的模式而不是遇到第一個錯誤就return。這會讓自動化腳本在項(xiàng)目里更實(shí)用。比如Liststring errors new Liststring(); foreach (var guid in guids) { try { // 操作 } catch (System.Exception e) { errors.Add(${path}: {e.Message}); } } if (errors.Count 0) { Debug.LogError($批量操作完成但有 {errors.Count} 個錯誤:\n{string.Join(\n, errors)}); } else { Debug.Log(批量操作全部成功); }這樣做的好處是即使有個別資產(chǎn)異常其他資產(chǎn)也能繼續(xù)處理而且最后你看到的錯誤日志包含路徑和原因可以直接定位到具體文件。5. 進(jìn)階與架構(gòu)建議5.1 把自動化操作封裝成通用模塊寫多了就會發(fā)現(xiàn)不管是批量創(chuàng)建、批量修改還是CSV導(dǎo)入代碼里都有一塊“找資產(chǎn)、加StartAssetEditing、SaveAssets、Refresh”的模板。我建議把這部分抽成獨(dú)立工具類比如AssetBatchHelper讓具體業(yè)務(wù)腳本只關(guān)心字段怎么填。這樣你的工具包會越來越干凈新需求幾分鐘就能接入。一個簡化的封裝思路public static class AssetBatchHelper { public static T[] LoadAllAssetsT(string searchFolder null) where T : ScriptableObject { string[] guids string.IsNullOrEmpty(searchFolder) ? AssetDatabase.FindAssets($t:{typeof(T).Name}) : AssetDatabase.FindAssets($t:{typeof(T).Name}, new[] { searchFolder }); T[] result new T[guids.Length]; for (int i 0; i guids.Length; i) { string path AssetDatabase.GUIDToAssetPath(guids[i]); result[i] AssetDatabase.LoadAssetAtPathT(path); } return result; } public static void BatchEdit(Action editAction) { AssetDatabase.StartAssetEditing(); try { editAction(); } finally { AssetDatabase.StopAssetEditing(); } AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); } }然后在具體業(yè)務(wù)里這樣調(diào)用private static void UpdateAll() { var items AssetBatchHelper.LoadAllAssetsItemData(Assets/Items); AssetBatchHelper.BatchEdit(() { foreach (var item in items) { Undo.RecordObject(item, Update); item.maxStack 999; EditorUtility.SetDirty(item); } }); }這里直接改字段并SetDirty也是一個可行模式尤其是當(dāng)字段不需要Inspector刷新、且你已經(jīng)習(xí)慣了直接操作對象時(shí)。不過要注意直接改字段時(shí)不支持SerializedProperty所以撤銷需要使用Undo.RecordObject。我自己的習(xí)慣是簡單字段直接改SetDirty涉及數(shù)組/嵌套引用時(shí)用SerializedObject這樣可以減少很多類型轉(zhuǎn)換的麻煩。5.2 給自動化工具加一個可視化窗口命令行式菜單雖然方便編程的人但策劃和非技術(shù)同事用起來不直觀。這時(shí)候可以在EditorWindow里做一個小工具面板用按鈕和輸入框把操作暴露出來。比如一個窗口里有三個按鈕“批量創(chuàng)建”“批量修改”“CSV導(dǎo)入”還有一個文本框顯示日志。渲染邏輯不復(fù)雜主要是繼承EditorWindow在OnGUI里用GUILayout畫控件然后綁定MenuItem打開窗口。這種方式能把工具的門檻降到“點(diǎn)按鈕”級別也能避免操作人員手誤運(yùn)行了危險(xiǎn)命令。我往往會加一個確認(rèn)彈窗if (!EditorUtility.DisplayDialog(確認(rèn), $即將修改 {count} 個資產(chǎn), 是否繼續(xù)?, 確認(rèn), 取消)) { return; }這招在自動化腳本里特別重要因?yàn)樗茉谀阏`點(diǎn)菜單或沒拿準(zhǔn)數(shù)據(jù)格式時(shí)救你一命。5.3 接入AssetPostprocessor和CI如果你對自動化要求更高可以把它嵌到Unity的導(dǎo)入管線里。比如寫一個AssetPostprocessor在onPostprocessAllAssets回調(diào)里檢測到某個目錄新增了CSV文件就自動執(zhí)行導(dǎo)入生成ScriptableObject。不過這要謹(jǐn)慎因?yàn)閷?dǎo)入管線是每次進(jìn)編輯器都可能觸發(fā)處理不當(dāng)會讓編輯器卡頓。更保險(xiǎn)的做法是在CI持續(xù)集成流程中跑編輯器腳本。比如在Jenkins或GitHub Actions里執(zhí)行Unity的批處理命令調(diào)用Unity.exe -batchmode -projectPath xxx -executeMethod YourTool.BatchImport -quit讓導(dǎo)入腳本自動生成全部配置資產(chǎn)再導(dǎo)出為AssetBundle。這樣做能保證每次構(gòu)建前的配置都是最新的也能在版本控制里看到資產(chǎn)更新。寫批處理調(diào)用時(shí)注意純批處理模式?jīng)]有UIEditorUtility.DisplayDialog這類需要用戶交互的API不能直接調(diào)用要提前判斷Application.isBatchMode跳過。5.4 把數(shù)據(jù)驅(qū)動與自動化操作結(jié)合ScriptableObject的自動化操作不只是“改數(shù)據(jù)”還可以和數(shù)據(jù)驅(qū)動工具聯(lián)動。比如你可以寫一個工具根據(jù)命名規(guī)則自動為每個角色生成一組技能配置資產(chǎn)再寫一個工具統(tǒng)計(jì)所有技能配置的強(qiáng)度曲線并輸出報(bào)告。這類工具其實(shí)都在做同一件事把本來要靠人維護(hù)的配置變成由規(guī)則和代碼維護(hù)。數(shù)據(jù)驅(qū)動的好處是當(dāng)策劃調(diào)整數(shù)值公式時(shí)你不需要改幾十個資產(chǎn)只需要改工具里的公式然后一鍵重跑。久而久之配置的準(zhǔn)確性、一致性會顯著提升。寫在最后的個人經(jīng)驗(yàn)回想起來我用編輯器腳本批量操作ScriptableObject的最大心得是永遠(yuǎn)先把“找資產(chǎn)”和“改資產(chǎn)”分開寫。找資產(chǎn)的方式主要靠FindAssets、GUID或路徑改資產(chǎn)的方式要么是SerializedObject要么是直接SetDirty。只要這兩個概念清晰剩下的就是組合。另一個很實(shí)用的小技巧是在批量操作前先在內(nèi)存里打印一份《將要修改的資產(chǎn)清單》確認(rèn)無誤再執(zhí)行尤其是要改幾十上百個資產(chǎn)的時(shí)候。腳本不是用來省一次確認(rèn)的是用來減少重復(fù)勞動和人為失誤的。我后來做項(xiàng)目凡是涉及“改配置”的需求第一反應(yīng)都是寫個幾行代碼的菜單項(xiàng)而不是打開Inspector一個個點(diǎn)。這個習(xí)慣幫我省了不知多少時(shí)間。