当前位置：首页 > news >正文

Unity编辑器脚本批量替换预制体Text组件字体方案

news 2026/5/11 22:27:14

1. 为什么需要批量替换预制体中的字体？

在Unity项目开发中，我们经常会遇到需要统一修改UI字体的情况。比如项目从旧版本升级到Unity 2022后，原先使用的Arial字体被移除，Text组件也被标记为Legacy组件。这时候如果手动一个个修改预制体中的字体，不仅效率低下，还容易遗漏。

我最近就遇到了这样的问题：一个包含300多个预制体的项目需要将所有Text组件的字体从LegacyRuntime.ttf替换为思源黑体。手动操作不仅耗时2天，还漏改了十几个预制体，导致测试阶段才发现问题。这就是为什么我们需要编写编辑器脚本来实现批量替换。

2. 准备工作：了解关键组件和API

2.1 Text组件与字体资源

Unity中的Text组件是UI系统的基础元素，负责显示文字内容。每个Text组件都有一个font属性，决定了文字的显示样式。在项目中，字体资源通常以.ttf或.otf格式存放在Assets目录下。

需要注意的是，从Unity 2022开始：

原生的Text组件被标记为Legacy
内置的Arial字体被移除
升级后的项目会自动使用LegacyRuntime.ttf
这个默认字体不支持中文显示

2.2 关键API解析

实现批量替换需要掌握几个关键API：

AssetDatabase.FindAssets: 用于查找项目中所有预制体
AssetDatabase.LoadAssetAtPath: 加载指定路径的资源
GetComponentsInChildren: 获取预制体中的所有Text组件
EditorUtility.SetDirty: 标记对象为"脏"状态
AssetDatabase.SaveAssets: 保存所有修改

3. 完整脚本实现步骤

3.1 创建编辑器窗口

首先创建一个继承自EditorWindow的类，用来提供可视化操作界面：

using UnityEditor; using UnityEngine; using UnityEngine.UI; public class FontReplacer : EditorWindow { private Font targetFont; [MenuItem("Tools/批量替换字体")] public static void ShowWindow() { GetWindow<FontReplacer>("字体替换工具"); } }

3.2 实现字体替换逻辑

在窗口类中添加核心替换方法：

private void ReplaceFontsInPrefabs() { // 加载目标字体 targetFont = AssetDatabase.LoadAssetAtPath<Font>("Assets/Fonts/YourFont.ttf"); if(targetFont == null) { Debug.LogError("字体文件加载失败，请检查路径"); return; } // 查找所有预制体 string[] prefabGUIDs = AssetDatabase.FindAssets("t:Prefab", new[] { "Assets" }); int replacedCount = 0; foreach(string guid in prefabGUIDs) { string path = AssetDatabase.GUIDToAssetPath(guid); GameObject prefab = AssetDatabase.LoadAssetAtPath<GameObject>(path); Text[] textComponents = prefab.GetComponentsInChildren<Text>(true); foreach(Text text in textComponents) { text.font = targetFont; EditorUtility.SetDirty(text); replacedCount++; } if(textComponents.Length > 0) { EditorUtility.SetDirty(prefab); } } AssetDatabase.SaveAssets(); Debug.Log($"已完成替换，共修改{replacedCount}个Text组件"); }

3.3 添加UI界面

最后在OnGUI方法中添加界面元素：

private void OnGUI() { GUILayout.Label("批量字体替换工具", EditorStyles.boldLabel); targetFont = (Font)EditorGUILayout.ObjectField("目标字体", targetFont, typeof(Font), false); if(GUILayout.Button("开始替换")) { if(EditorUtility.DisplayDialog("确认", "确定要替换所有预制体中的字体吗？", "确定", "取消")) { ReplaceFontsInPrefabs(); } } }

4. 实际应用中的注意事项

4.1 字体文件路径问题

在实际项目中，字体文件的存放位置可能会变化。我建议采用以下几种方案：

在脚本中添加路径检查逻辑：

if(!System.IO.File.Exists(Application.dataPath + "/Fonts/YourFont.ttf")) { Debug.LogError("字体文件不存在于预期路径"); return; }

使用资源选择器让用户手动选择字体：

targetFont = EditorGUILayout.ObjectField("选择字体", targetFont, typeof(Font), false) as Font;

4.2 性能优化建议

当项目中有大量预制体时，替换操作可能会比较耗时。可以考虑以下优化：

添加进度条显示：

EditorUtility.DisplayProgressBar("处理中", "正在替换字体...", progress); // 处理完成后 EditorUtility.ClearProgressBar();

分批处理预制体，避免一次性加载过多资源
添加撤销支持：

Undo.RecordObject(textComponent, "Change Font"); textComponent.font = targetFont;

4.3 异常处理

健壮的脚本应该能处理各种异常情况：

预制体加载失败
字体资源丢失
无权限修改预制体
版本控制冲突

建议添加try-catch块捕获异常，并提供有意义的错误信息。

5. 扩展功能：支持多种替换场景

5.1 按指定字体替换

有时候我们只需要替换特定字体，而不是全部Text组件。可以修改替换逻辑：

public Font fontToReplace; // 在UI中暴露这个字段 // 在替换逻辑中添加判断 if(text.font == fontToReplace || fontToReplace == null) { text.font = targetFont; }

5.2 支持TextMeshPro

现代项目更多使用TextMeshPro，可以扩展脚本支持：

#if TMP_PRESENT using TMPro; // 添加TMP替换逻辑 TMP_Text[] tmpTexts = prefab.GetComponentsInChildren<TMP_Text>(true); foreach(TMP_Text tmpText in tmpTexts) { // TMP使用FontAsset而不是Font tmpText.font = targetTMPFont; EditorUtility.SetDirty(tmpText); } #endif

5.3 添加预览功能

在替换前可以先扫描并显示将要修改的预制体列表：

private void ScanPrefabs() { // 扫描逻辑... // 显示结果在滚动视图 scrollPos = EditorGUILayout.BeginScrollView(scrollPos); foreach(var item in prefabList) { EditorGUILayout.LabelField(item); } EditorGUILayout.EndScrollView(); }