1. 项目概述为什么我们需要动态生成最小字体集如果你在Unity项目里用过TextMeshPro简称TMP做中文本地化大概率踩过这两个坑一是字体边缘发虚、模糊像蒙了一层雾二是运行时突然冒出几个方框□或者乱码尤其是当你的游戏需要支持多语言或者剧情文本量巨大时。这两个问题看似无关实则同根同源——都出在字体文件Font Asset的生成策略上。传统的做法是美术或策划给一份包含所有可能用到的中文文本我们一股脑儿地导入TMP的Font Asset Creator生成一个包含几千甚至上万个字符的字体图集Font Atlas。这个“全家桶”式的方法简单粗暴但后患无穷。首先巨大的纹理图集比如4096x4096甚至更大会显著增加内存占用和包体大小。其次为了把所有字都塞进去每个字形的像素空间被严重压缩导致边缘采样时精度不足这就是字体渲染出来“糊”掉的直接原因。最后你永远无法保证策划的文本囊括了所有可能性一个生僻字、一个特殊符号甚至是一个从服务器动态下发的玩家昵称都可能成为那个漏网之鱼导致运行时显示为方框。“动态生成最小字体集”这个方案就是为了根治这些问题。它的核心思想是按需生成实时扩展。我们不再预先制作一个庞大的、静态的字体文件。相反我们从一个极小的、仅包含基础字符如ASCII码的字体资产开始。在游戏运行时当TMP需要渲染一个当前字体集中不存在的字符时系统会动态地将这个新字符“烘焙”到字体图集中并更新字体资产的字符映射关系。这样最终在内存中存在的只是一个恰好包含了游戏实际用到的所有字符的、紧凑的字体集。内存占用最小化同时因为每个字符都有充足的纹理空间渲染质量也达到了最优。这不仅仅是性能优化更是提升产品品质的必经之路。想象一下你的游戏在全球发行支持简中、繁中、日文、韩文。如果为每种语言都预生成一个全字符集的字体包体将臃肿不堪。而动态生成方案可以让所有语言共享同一套底层机制根据玩家实际看到的文本来动态构建字体优雅且高效。2. 核心原理与架构设计2.1 TextMeshPro字体渲染机制拆解要理解动态生成必须先吃透TMP的字体工作流程。TMP不使用系统字体进行实时矢量渲染而是采用“预烘焙位图”的方式。这个过程分为两个阶段编辑期/构建期Font Asset Creation通过TMP的Font Asset Creator工具选择一个TrueType或OpenType字体源文件如微软雅黑.ttf指定一个字符集Character Set点击Generate。工具会做以下几件事字形解析读取字体文件根据指定的字符Unicode码点获取每个字符的矢量轮廓信息。栅格化Rasterization将这些矢量轮廓在指定的分辨率Atlas Resolution下渲染成位图bitmap。纹理打包Packing将所有字符的位图紧凑地排列在一张或多张纹理Texture上形成字体图集Font Atlas。同时生成一个“字符-纹理UV”映射表记录每个字符在图集上的位置和大小。生成Font Asset最终产出一个.asset文件里面包含了字体图集纹理的引用、字符映射表、字体度量信息如基线、升部、降部等。运行期Rendering当Canvas需要渲染一个TMP文本时UGUI会遍历文本字符串中的每个字符。根据字符的Unicode码点去查询当前使用的Font Asset中的映射表。如果找到则获取该字符在图集上的UV坐标结合网格顶点信息将图集上对应的那块纹理“贴”到屏幕的相应位置。如果找不到TMP会回退到“缺失字符Missing Character” glyph通常显示为一个方框□。动态生成方案本质上是将编辑期的“栅格化”和“纹理打包”能力部分地移植到了运行期。当发生“找不到字符”的情况时我们不显示方框而是拦截这个请求实时地调用底层字体引擎如FreeType库在Unity中通过FontEngine类封装去栅格化这个新字符并将其添加到现有的字体图集中。2.2 动态生成最小字体集的系统架构一个健壮的动态字体系统需要以下几个核心模块基础字体资产Base Font Asset这是动态系统的起点。它通常只包含最基本的字符例如ASCII字符0-127、常用标点。这个资产在编辑期预生成并作为预制体或资源的一部分打包。它的图集预留了足够的空白空间通过设置较大的Atlas Padding用于后续动态添加字符。字符请求拦截与调度器Character Request Interceptor Scheduler我们需要监听TMP何时遇到了缺失字符。这可以通过继承TMP_FontAsset类并重写相关方法或者更常见地通过一个全局管理器来监听TextMeshProUGUI的OnFontAssetRequest事件这是一个自定义事件需自己实现事件机制。当缺失字符被发现该模块负责将字符的Unicode码点加入处理队列。动态字形生成器Dynamic Glyph Generator这是系统的核心。它接收Unicode码点执行以下操作加载字体源文件.ttf/.otf到内存。注意字体文件需要随包发布或从服务器动态下载。调用FontEngine的LoadFontFace加载字体面孔GetGlyphIndex获取字形索引RenderGlyph或GlyphTryAdd等API将指定字符栅格化生成一个Glyph对象其中包含了该字符的位图数据、度量信息等。纹理图集管理器Atlas Texture Manager负责管理基础字体资产的那张纹理。当新的字形位图生成后这个模块需要检查当前纹理的空白区域是否足以容纳新字形。如果空间不足有两种策略纹理扩容Resize创建一张更大的新纹理如尺寸翻倍将旧纹理内容拷贝过去然后在新纹理的空白处添加新字形。此操作开销较大。纹理重组Repack类似于编辑器的打包过程将所有已存在的字形和新字形重新计算最优布局生成一张新纹理。开销最大但空间利用率最高。通常为了性能我们采用“预分配扩容”策略。初始纹理预留较大空间如1024x1024并记录一个简单的“空白矩形列表”。添加字形时使用简单的“首次适应”算法在空白列表中寻找位置。仅当空间真正耗尽时才触发扩容。字体资产更新器Font Asset Updater将新生成的Glyph信息包括其在新纹理图集上的矩形区域添加到基础字体资产的字符映射表中。同时需要更新字体资产的版本或哈希值并通知所有正在使用该字体资产的TMP文本组件进行重建Rebuild。这是关键一步否则新字符虽然加入了图集但文本显示不会刷新。缓存与持久化Cache Persistence为了提升性能可以将运行时动态生成的字符集Unicode列表保存下来如存为JSON。下次游戏启动时可以直接用这个列表在加载阶段预生成字体避免运行时的卡顿。这对于剧情已经解锁的离线游戏特别有用。注意动态修改TMP_FontAsset是一种“非托管”操作需要谨慎处理多线程和内存。确保字符添加和纹理更新在主线程进行并注意对动态纹理的引用管理避免内存泄漏。3. 分步实现与核心代码解析下面我将以一个具体的实现流程为例拆解关键步骤和代码。我们假设项目使用Unity 2022.3 LTS TextMeshPro 版本为3.0。3.1 准备阶段创建基础字体资产导入字体源文件将你的中文字体文件例如SourceHanSansCN-Regular.otf放入项目Resources文件夹或Addressables可寻址路径下。不推荐放在StreamingAssets因为FontEngine的某些API在StreamingAssets路径下可能需要特殊处理。生成基础Font Asset在Unity编辑器中打开Window TextMeshPro Font Asset Creator。Source Font File选择你的中文字体文件。Character Set选择Custom Characters。在自定义字符框中输入最基础的字符集。例如ASCII字符!\#$%()*,-./0123456789:;?ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_\abcdefghijklmnopqrstuvwxyz{|}~再加上几个常用的中文标点如“。、‘””等。总共可能就200-300个字符。Atlas Resolution设置为1024 x 1024。虽然初始字符少但我们预留空间。Atlas Padding设置为5。填充像素可以防止字符边缘在缩放时相互渗色。Render Mode选择Smooth以获得更好的抗锯齿效果。点击Generate Font Atlas预览无误后保存为DynamicFontBase.asset。这个基础资产就是我们的“种子”。3.2 构建动态字体管理器DynamicFontManager这是核心的单例管理器。using System; using System.Collections.Generic; using UnityEngine; using TMPro; using Unity.Collections; using UnityEngine.TextCore; using UnityEngine.TextCore.LowLevel; public class DynamicFontManager : MonoBehaviour { public static DynamicFontManager Instance { get; private set; } [Header(基础配置)] public TMP_FontAsset baseFontAsset; // 拖入刚刚创建的基础字体资产 public Font sourceFont; // 拖入用于动态生成的TrueType/OpenType字体文件在Unity中作为Font导入 public int atlasResolution 1024; public int padding 5; private Texture2D m_DynamicAtlasTexture; private bool m_IsAtlasTextureDirty false; private Queueint m_PendingCharacters new Queueint(); private HashSetint m_AddedCharacters new HashSetint(); private void Awake() { if (Instance ! null Instance ! this) { Destroy(gameObject); return; } Instance this; DontDestroyOnLoad(gameObject); InitializeDynamicAtlas(); } private void InitializeDynamicAtlas() { // 1. 获取基础字体资产的原始图集纹理 Texture2D baseTexture baseFontAsset.atlasTexture; if (baseTexture null) { Debug.LogError(基础字体资产没有图集纹理); return; } // 2. 创建一张新的可读写纹理作为动态图集 m_DynamicAtlasTexture new Texture2D(atlasResolution, atlasResolution, TextureFormat.Alpha8, false); m_DynamicAtlasTexture.filterMode FilterMode.Bilinear; Graphics.CopyTexture(baseTexture, 0, 0, m_DynamicAtlasTexture, 0, 0); // 3. 将基础字体资产的图集引用替换为我们动态的这张 baseFontAsset.atlasTexture m_DynamicAtlasTexture; // 4. 初始化已添加字符集合从基础资产中读取 foreach (var character in baseFontAsset.characterTable) { m_AddedCharacters.Add(character.unicode); } } }3.3 实现字符请求与添加逻辑在DynamicFontManager中继续添加以下关键方法public void RequestCharactersForText(string text) { foreach (char c in text) { int unicode (int)c; // 如果字符不在基础资产中且未被添加过则加入待处理队列 if (!m_AddedCharacters.Contains(unicode) !m_PendingCharacters.Contains(unicode)) { // 可以在这里过滤掉非目标语言文字范围的字符如只处理CJK统一表意文字 if (IsCJKUnifiedIdeograph(unicode)) // 这是一个自定义的CJK字符范围判断函数 { m_PendingCharacters.Enqueue(unicode); } } } // 可以立即处理也可以延迟到下一帧处理以避免卡顿 ProcessPendingCharacters(); } private bool IsCJKUnifiedIdeograph(int unicode) { // CJK统一表意文字范围 (粗略判断) return (unicode 0x4E00 unicode 0x9FFF) || (unicode 0x3400 unicode 0x4DBF) || (unicode 0x20000 unicode 0x2A6DF) || (unicode 0x2A700 unicode 0x2B73F) || (unicode 0x2B740 unicode 0x2B81F) || (unicode 0x2B820 unicode 0x2CEAF) || (unicode 0xF900 unicode 0xFAFF) || (unicode 0x2F800 unicode 0x2FA1F); } private void ProcessPendingCharacters() { while (m_PendingCharacters.Count 0) { int unicode m_PendingCharacters.Dequeue(); if (TryAddCharacter(unicode)) { m_AddedCharacters.Add(unicode); } else { // 添加失败可能是图集已满重新入队或记录错误 Debug.LogWarning($无法添加字符: {(char)unicode} (U{unicode:X4})图集可能已满。); } } // 如果有字符被成功添加需要更新使用此字体的所有文本 if (m_IsAtlasTextureDirty) { UpdateAllTextComponents(); m_IsAtlasTextureDirty false; } } private bool TryAddCharacter(int unicode) { // 1. 加载字体面孔 FontEngineError error FontEngine.LoadFontFace(sourceFont, 90); // 90是默认DPI可调整 if (error ! FontEngineError.Success) { Debug.LogError($加载字体面孔失败: {error}); return false; } // 2. 获取字形索引 uint glyphIndex FontEngine.GetGlyphIndex((uint)unicode); if (glyphIndex 0) { // 0通常表示未找到字形 return false; } // 3. 渲染字形 Glyph glyph; error FontEngine.TryGetGlyphWithIndexValue(glyphIndex, GlyphLoadFlags.LOAD_RENDER, out glyph); if (error ! FontEngineError.Success || glyph.glyphId 0) { // 尝试另一种方式使用TryAddGlyphToTexture它会自动处理图集 // 这是更推荐的方式因为它直接处理了纹理打包 if (FontEngine.TryAddGlyphToTexture(glyphIndex, baseFontAsset.atlasPadding, GlyphPackingMode.BestShortSideFit, baseFontAsset.atlasRenderMode, m_DynamicAtlasTexture, out glyph)) { // 4. 将新字形添加到字体资产中 TMP_Character character new TMP_Character(unicode, glyph); baseFontAsset.characterTable.Add(character); // 更新字形查找表重要 baseFontAsset.UpdateGlyphLookupTable(); m_IsAtlasTextureDirty true; return true; } else { Debug.LogError($无法将字形添加到纹理: {error}); return false; } } return false; }3.4 驱动文本更新当字体资产更新后所有使用它的TextMeshProUGUI组件都需要被标记为脏以触发网格重建。private void UpdateAllTextComponents() { // 方法一遍历场景中所有使用此字体资产的TextMeshProUGUI var allTexts FindObjectsOfTypeTextMeshProUGUI(true); // true表示包含未激活的 foreach (var text in allTexts) { if (text.font baseFontAsset) { text.ForceMeshUpdate(true); // 强制立即更新网格 // 或者使用 text.SetAllDirty(); 标记脏等待Canvas更新 } } // 方法二更高效如果你能管理文本组件的引用可以维护一个列表 // 在文本组件Awake/OnEnable时注册OnDisable/OnDestroy时注销。 // 然后直接遍历这个列表进行更新。 }3.5 集成到文本显示流程最后我们需要一个机制在文本显示前确保其字符已被加载。可以创建一个DynamicText组件。[RequireComponent(typeof(TextMeshProUGUI))] public class DynamicText : MonoBehaviour { private TextMeshProUGUI m_TextComponent; private void Awake() { m_TextComponent GetComponentTextMeshProUGUI(); // 确保文本使用我们的动态字体 if (m_TextComponent.font ! DynamicFontManager.Instance.baseFontAsset) { m_TextComponent.font DynamicFontManager.Instance.baseFontAsset; } } private void Start() { // 在Start时请求字符因为文本内容可能在Awake后设置 RequestCharacters(); } public void SetText(string newText) { m_TextComponent.text newText; RequestCharacters(); } private void RequestCharacters() { if (DynamicFontManager.Instance ! null !string.IsNullOrEmpty(m_TextComponent.text)) { DynamicFontManager.Instance.RequestCharactersForText(m_TextComponent.text); } } }将DynamicText组件挂载到你的TMP文本对象上它会在初始化时和文本变化时自动向管理器请求所需的字符。4. 性能优化与高级技巧动态生成虽然强大但不当使用会导致运行时卡顿特别是添加大量新字符时。以下是关键的优化策略4.1 预加载与分批处理不要等到屏幕上弹出文本时才去加载字符。对于已知的文本内容如UI界面固定文字、章节标题可以在场景加载时、或进入某个界面之前进行预加载。// 在加载场景或进入界面时 IEnumerator PreloadFontCharacters(Liststring knownTexts) { HashSetint allChars new HashSetint(); foreach (var text in knownTexts) { foreach (char c in text) { allChars.Add((int)c); } } // 分批处理每帧添加N个避免单帧卡顿 int batchSize 10; int processed 0; foreach (int unicode in allChars) { if (!DynamicFontManager.Instance.IsCharacterAdded(unicode)) { DynamicFontManager.Instance.RequestCharacterImmediate(unicode); // 假设有立即添加的API processed; if (processed % batchSize 0) { yield return null; // 下一帧继续 } } } }4.2 纹理图集管理策略初始尺寸选择根据项目规模预估。对于手机游戏1024x1024是平衡点对于PC或主机可以考虑2048x2048起步。扩容策略当图集满时直接创建一张新的大纹理如尺寸翻倍并拷贝旧数据比复杂的“重组”更高效。因为Graphics.CopyTexture是GPU操作速度很快。多图集支持TMP Font Asset本身支持多张纹理atlasTextures数组。当一张图集满后可以创建第二张、第三张图集。这比不断扩容一张巨幅纹理更灵活但需要修改字体资产的内部逻辑以支持跨图集查询。4.3 内存与缓存持久化动态生成的字符集是运行时状态。为了提升用户体验避免每次游戏启动都重新动态生成已见过的字符需要将其持久化。// 保存 public void SaveDynamicCharacterSet() { Listint charList new Listint(m_AddedCharacters); string json JsonUtility.ToJson(new CharacterSetData { characters charList }); System.IO.File.WriteAllText(Application.persistentDataPath /dynamic_charset.json, json); } // 加载 public void LoadAndPregenerateCharacterSet() { string path Application.persistentDataPath /dynamic_charset.json; if (System.IO.File.Exists(path)) { string json System.IO.File.ReadAllText(path); CharacterSetData data JsonUtility.FromJsonCharacterSetData(json); StartCoroutine(PreloadCharactersCoroutine(data.characters)); } } [System.Serializable] private class CharacterSetData { public Listint characters; }在游戏启动时或主菜单界面调用LoadAndPregenerateCharacterSet在后台线程或分帧将字符预生成到字体图集中这样玩家进入游戏时绝大部分文字都已经就绪。4.4 针对不同平台的注意事项WebGL由于浏览器环境限制字体文件的加载和FontEngine的调用可能与Standalone平台有差异。确保字体文件通过UnityWebRequest正确加载并注意同步/异步问题。WebGL上文件系统访问受限持久化缓存可能需要使用PlayerPrefs或IndexedDB。移动端iOS/Android注意内存一张1024x1024的Alpha8纹理占用1MB内存。频繁的纹理创建和拷贝扩容会触发GC引起卡顿。务必做好预加载和缓存避免在性能关键帧如战斗场景进行动态添加。字体版权动态加载的字体文件必须确保你有分发版权。不要将商业字体直接打包进项目除非已获得授权。可以考虑使用开源字体如思源黑体、得意黑或向字体厂商购买相应的授权。5. 常见问题排查与实战心得在实际项目中你会遇到各种各样奇怪的问题。下面是我踩过的一些坑和解决方案5.1 问题动态添加的字符显示为乱码或错误字形可能原因1字体源文件不匹配。你动态加载的.ttf文件与创建基础Font Asset时使用的字体文件不是同一个系列、同一个字重如Regular、Bold。即使名字相同版本不同也可能导致字形轮廓差异。排查检查DynamicFontManager中sourceFont引用的Font对象是否与生成基础资产时选择的源文件完全一致。可能原因2DPI/字号设置不一致。FontEngine.LoadFontFace时指定的pointSize上面代码中的90参数会影响栅格化的尺寸和质量。这个值需要与创建基础字体资产时的设置匹配。排查在Font Asset Creator生成基础资产时记录下使用的Point Size通常在Generation Settings里。在运行时LoadFontFace时使用相同的值。可能原因3字符映射错误。TMP_Character创建时Unicode码点传错了或者glyph索引不对。排查在TryAddCharacter方法中添加调试日志打印出unicode和glyph.glyphId。确保glyphId不为0。5.2 问题字体边缘依然模糊可能原因1图集分辨率过低或Padding不足。即使动态添加如果初始图集分辨率设得太小如256x256或者Padding为0当字符数量增多后每个字符分到的像素依然很少且边缘可能和相邻字符像素混合。解决提高atlasResolution如1024或2048并设置合理的padding5-10像素。可能原因2纹理过滤模式。动态图集纹理的filterMode设置为Bilinear或Trilinear在文本缩放时会导致模糊。解决对于像素艺术或需要锐利边缘的UI可以尝试设置为Point无过滤。但通常Bilinear是UI文本的最佳选择。确保你的Canvas Scaler设置合理避免文本被非整数倍缩放。可能原因3抗锯齿Render Mode。在FontEngine.TryAddGlyphToTexture中我们传入了baseFontAsset.atlasRenderMode。这个模式如Smooth需要与基础资产创建时保持一致。如果基础资产用RasterHinted栅格提示模式生成而动态添加用Smooth风格会不统一。解决统一使用Smooth模式以获得高质量的平滑边缘。5.3 问题运行时添加字符导致明显卡顿可能原因单帧添加字符过多。ProcessPendingCharacters在一个循环里处理所有待处理字符如果一段新文本包含上百个生僻字主线程就会卡住。解决实现分帧处理。将ProcessPendingCharacters改造成协程每帧只处理固定数量如5-10个的字符处理完后yield return null。private IEnumerator ProcessPendingCharactersCoroutine(int charsPerFrame 5) { while (m_PendingCharacters.Count 0) { int processedThisFrame 0; while (m_PendingCharacters.Count 0 processedThisFrame charsPerFrame) { // ... 处理单个字符的逻辑 ... processedThisFrame; } m_IsAtlasTextureDirty true; yield return null; // 下一帧继续 } if (m_IsAtlasTextureDirty) { UpdateAllTextComponents(); m_IsAtlasTextureDirty false; } }在RequestCharactersForText中不要直接调用ProcessPendingCharacters()而是启动这个协程确保只有一个实例在运行。5.4 问题文本更新后新字符不显示需要鼠标划过或切换界面才显示可能原因文本组件没有及时重建Rebuild。我们更新了字体资产的图集和字符表但使用该字体的TextMeshProUGUI组件没有收到“需要重建网格”的通知。解决确保UpdateAllTextComponents方法被正确调用并且它确实能触发网格更新。ForceMeshUpdate(true)是强制立即重建。如果文本在滚动视图或其他复杂布局组中可能需要调用Canvas.ForceUpdateCanvases()来驱动整个Canvas的布局重建。更可靠的方法是直接设置text.text text.text;触发内部脏标记但这可能影响性能。最佳实践是维护一个需要更新的文本组件列表只更新受影响的组件。5.5 实战心得关于“Fallback Font”的陷阱TMP有一个强大的功能叫Fallback Font后备字体。当主字体找不到字符时会去Fallback列表里的字体寻找。这听起来是动态生成的完美补充但混用时要小心。如果你的动态字体是主字体并设置了一个包含全字符集的静态字体作为Fallback。那么当一个缺失字符出现时TMP会优先使用Fallback字体中的字符来显示而不是触发你的动态生成逻辑。因为Fallback的查询发生在字体资产的内部早于你拦截缺失字符的时机。建议在实现动态字体系统时清空或谨慎配置该动态字体资产的Fallback列表。确保缺失字符的“回退”行为由你的DynamicFontManager完全控制。你可以将Fallback用于另一种用途例如用另一个简单的英文字体作为动态中文字体的Fallback专门处理某些特殊符号但这需要精细的测试。动态生成最小字体集是一个“一劳永逸”解决TMP中文显示问题的方案它要求开发者对TMP的内部机制有更深的理解。一旦搭建成功它将极大地提升项目的文本渲染质量、减少内存开销并为多语言支持打下坚实基础。上面的代码和方案是一个起点在实际项目中你可能需要根据具体的UI框架、资源管理方式如Addressables进行适配和封装。记住充分测试是唯一标准尤其是在低端移动设备上要密切关注内存和帧率变化。
1. 项目概述为什么我们需要动态生成最小字体集如果你在Unity项目里用过TextMeshPro简称TMP做中文本地化大概率踩过这两个坑一是字体边缘发虚、模糊像蒙了一层雾二是运行时突然冒出几个方框□或者乱码尤其是当你的游戏需要支持多语言或者剧情文本量巨大时。这两个问题看似无关实则同根同源——都出在字体文件Font Asset的生成策略上。传统的做法是美术或策划给一份包含所有可能用到的中文文本我们一股脑儿地导入TMP的Font Asset Creator生成一个包含几千甚至上万个字符的字体图集Font Atlas。这个“全家桶”式的方法简单粗暴但后患无穷。首先巨大的纹理图集比如4096x4096甚至更大会显著增加内存占用和包体大小。其次为了把所有字都塞进去每个字形的像素空间被严重压缩导致边缘采样时精度不足这就是字体渲染出来“糊”掉的直接原因。最后你永远无法保证策划的文本囊括了所有可能性一个生僻字、一个特殊符号甚至是一个从服务器动态下发的玩家昵称都可能成为那个漏网之鱼导致运行时显示为方框。“动态生成最小字体集”这个方案就是为了根治这些问题。它的核心思想是按需生成实时扩展。我们不再预先制作一个庞大的、静态的字体文件。相反我们从一个极小的、仅包含基础字符如ASCII码的字体资产开始。在游戏运行时当TMP需要渲染一个当前字体集中不存在的字符时系统会动态地将这个新字符“烘焙”到字体图集中并更新字体资产的字符映射关系。这样最终在内存中存在的只是一个恰好包含了游戏实际用到的所有字符的、紧凑的字体集。内存占用最小化同时因为每个字符都有充足的纹理空间渲染质量也达到了最优。这不仅仅是性能优化更是提升产品品质的必经之路。想象一下你的游戏在全球发行支持简中、繁中、日文、韩文。如果为每种语言都预生成一个全字符集的字体包体将臃肿不堪。而动态生成方案可以让所有语言共享同一套底层机制根据玩家实际看到的文本来动态构建字体优雅且高效。2. 核心原理与架构设计2.1 TextMeshPro字体渲染机制拆解要理解动态生成必须先吃透TMP的字体工作流程。TMP不使用系统字体进行实时矢量渲染而是采用“预烘焙位图”的方式。这个过程分为两个阶段编辑期/构建期Font Asset Creation通过TMP的Font Asset Creator工具选择一个TrueType或OpenType字体源文件如微软雅黑.ttf指定一个字符集Character Set点击Generate。工具会做以下几件事字形解析读取字体文件根据指定的字符Unicode码点获取每个字符的矢量轮廓信息。栅格化Rasterization将这些矢量轮廓在指定的分辨率Atlas Resolution下渲染成位图bitmap。纹理打包Packing将所有字符的位图紧凑地排列在一张或多张纹理Texture上形成字体图集Font Atlas。同时生成一个“字符-纹理UV”映射表记录每个字符在图集上的位置和大小。生成Font Asset最终产出一个.asset文件里面包含了字体图集纹理的引用、字符映射表、字体度量信息如基线、升部、降部等。运行期Rendering当Canvas需要渲染一个TMP文本时UGUI会遍历文本字符串中的每个字符。根据字符的Unicode码点去查询当前使用的Font Asset中的映射表。如果找到则获取该字符在图集上的UV坐标结合网格顶点信息将图集上对应的那块纹理“贴”到屏幕的相应位置。如果找不到TMP会回退到“缺失字符Missing Character” glyph通常显示为一个方框□。动态生成方案本质上是将编辑期的“栅格化”和“纹理打包”能力部分地移植到了运行期。当发生“找不到字符”的情况时我们不显示方框而是拦截这个请求实时地调用底层字体引擎如FreeType库在Unity中通过FontEngine类封装去栅格化这个新字符并将其添加到现有的字体图集中。2.2 动态生成最小字体集的系统架构一个健壮的动态字体系统需要以下几个核心模块基础字体资产Base Font Asset这是动态系统的起点。它通常只包含最基本的字符例如ASCII字符0-127、常用标点。这个资产在编辑期预生成并作为预制体或资源的一部分打包。它的图集预留了足够的空白空间通过设置较大的Atlas Padding用于后续动态添加字符。字符请求拦截与调度器Character Request Interceptor Scheduler我们需要监听TMP何时遇到了缺失字符。这可以通过继承TMP_FontAsset类并重写相关方法或者更常见地通过一个全局管理器来监听TextMeshProUGUI的OnFontAssetRequest事件这是一个自定义事件需自己实现事件机制。当缺失字符被发现该模块负责将字符的Unicode码点加入处理队列。动态字形生成器Dynamic Glyph Generator这是系统的核心。它接收Unicode码点执行以下操作加载字体源文件.ttf/.otf到内存。注意字体文件需要随包发布或从服务器动态下载。调用FontEngine的LoadFontFace加载字体面孔GetGlyphIndex获取字形索引RenderGlyph或GlyphTryAdd等API将指定字符栅格化生成一个Glyph对象其中包含了该字符的位图数据、度量信息等。纹理图集管理器Atlas Texture Manager负责管理基础字体资产的那张纹理。当新的字形位图生成后这个模块需要检查当前纹理的空白区域是否足以容纳新字形。如果空间不足有两种策略纹理扩容Resize创建一张更大的新纹理如尺寸翻倍将旧纹理内容拷贝过去然后在新纹理的空白处添加新字形。此操作开销较大。纹理重组Repack类似于编辑器的打包过程将所有已存在的字形和新字形重新计算最优布局生成一张新纹理。开销最大但空间利用率最高。通常为了性能我们采用“预分配扩容”策略。初始纹理预留较大空间如1024x1024并记录一个简单的“空白矩形列表”。添加字形时使用简单的“首次适应”算法在空白列表中寻找位置。仅当空间真正耗尽时才触发扩容。字体资产更新器Font Asset Updater将新生成的Glyph信息包括其在新纹理图集上的矩形区域添加到基础字体资产的字符映射表中。同时需要更新字体资产的版本或哈希值并通知所有正在使用该字体资产的TMP文本组件进行重建Rebuild。这是关键一步否则新字符虽然加入了图集但文本显示不会刷新。缓存与持久化Cache Persistence为了提升性能可以将运行时动态生成的字符集Unicode列表保存下来如存为JSON。下次游戏启动时可以直接用这个列表在加载阶段预生成字体避免运行时的卡顿。这对于剧情已经解锁的离线游戏特别有用。注意动态修改TMP_FontAsset是一种“非托管”操作需要谨慎处理多线程和内存。确保字符添加和纹理更新在主线程进行并注意对动态纹理的引用管理避免内存泄漏。3. 分步实现与核心代码解析下面我将以一个具体的实现流程为例拆解关键步骤和代码。我们假设项目使用Unity 2022.3 LTS TextMeshPro 版本为3.0。3.1 准备阶段创建基础字体资产导入字体源文件将你的中文字体文件例如SourceHanSansCN-Regular.otf放入项目Resources文件夹或Addressables可寻址路径下。不推荐放在StreamingAssets因为FontEngine的某些API在StreamingAssets路径下可能需要特殊处理。生成基础Font Asset在Unity编辑器中打开Window TextMeshPro Font Asset Creator。Source Font File选择你的中文字体文件。Character Set选择Custom Characters。在自定义字符框中输入最基础的字符集。例如ASCII字符!\#$%()*,-./0123456789:;?ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_\abcdefghijklmnopqrstuvwxyz{|}~再加上几个常用的中文标点如“。、‘””等。总共可能就200-300个字符。Atlas Resolution设置为1024 x 1024。虽然初始字符少但我们预留空间。Atlas Padding设置为5。填充像素可以防止字符边缘在缩放时相互渗色。Render Mode选择Smooth以获得更好的抗锯齿效果。点击Generate Font Atlas预览无误后保存为DynamicFontBase.asset。这个基础资产就是我们的“种子”。3.2 构建动态字体管理器DynamicFontManager这是核心的单例管理器。using System; using System.Collections.Generic; using UnityEngine; using TMPro; using Unity.Collections; using UnityEngine.TextCore; using UnityEngine.TextCore.LowLevel; public class DynamicFontManager : MonoBehaviour { public static DynamicFontManager Instance { get; private set; } [Header(基础配置)] public TMP_FontAsset baseFontAsset; // 拖入刚刚创建的基础字体资产 public Font sourceFont; // 拖入用于动态生成的TrueType/OpenType字体文件在Unity中作为Font导入 public int atlasResolution 1024; public int padding 5; private Texture2D m_DynamicAtlasTexture; private bool m_IsAtlasTextureDirty false; private Queueint m_PendingCharacters new Queueint(); private HashSetint m_AddedCharacters new HashSetint(); private void Awake() { if (Instance ! null Instance ! this) { Destroy(gameObject); return; } Instance this; DontDestroyOnLoad(gameObject); InitializeDynamicAtlas(); } private void InitializeDynamicAtlas() { // 1. 获取基础字体资产的原始图集纹理 Texture2D baseTexture baseFontAsset.atlasTexture; if (baseTexture null) { Debug.LogError(基础字体资产没有图集纹理); return; } // 2. 创建一张新的可读写纹理作为动态图集 m_DynamicAtlasTexture new Texture2D(atlasResolution, atlasResolution, TextureFormat.Alpha8, false); m_DynamicAtlasTexture.filterMode FilterMode.Bilinear; Graphics.CopyTexture(baseTexture, 0, 0, m_DynamicAtlasTexture, 0, 0); // 3. 将基础字体资产的图集引用替换为我们动态的这张 baseFontAsset.atlasTexture m_DynamicAtlasTexture; // 4. 初始化已添加字符集合从基础资产中读取 foreach (var character in baseFontAsset.characterTable) { m_AddedCharacters.Add(character.unicode); } } }3.3 实现字符请求与添加逻辑在DynamicFontManager中继续添加以下关键方法public void RequestCharactersForText(string text) { foreach (char c in text) { int unicode (int)c; // 如果字符不在基础资产中且未被添加过则加入待处理队列 if (!m_AddedCharacters.Contains(unicode) !m_PendingCharacters.Contains(unicode)) { // 可以在这里过滤掉非目标语言文字范围的字符如只处理CJK统一表意文字 if (IsCJKUnifiedIdeograph(unicode)) // 这是一个自定义的CJK字符范围判断函数 { m_PendingCharacters.Enqueue(unicode); } } } // 可以立即处理也可以延迟到下一帧处理以避免卡顿 ProcessPendingCharacters(); } private bool IsCJKUnifiedIdeograph(int unicode) { // CJK统一表意文字范围 (粗略判断) return (unicode 0x4E00 unicode 0x9FFF) || (unicode 0x3400 unicode 0x4DBF) || (unicode 0x20000 unicode 0x2A6DF) || (unicode 0x2A700 unicode 0x2B73F) || (unicode 0x2B740 unicode 0x2B81F) || (unicode 0x2B820 unicode 0x2CEAF) || (unicode 0xF900 unicode 0xFAFF) || (unicode 0x2F800 unicode 0x2FA1F); } private void ProcessPendingCharacters() { while (m_PendingCharacters.Count 0) { int unicode m_PendingCharacters.Dequeue(); if (TryAddCharacter(unicode)) { m_AddedCharacters.Add(unicode); } else { // 添加失败可能是图集已满重新入队或记录错误 Debug.LogWarning($无法添加字符: {(char)unicode} (U{unicode:X4})图集可能已满。); } } // 如果有字符被成功添加需要更新使用此字体的所有文本 if (m_IsAtlasTextureDirty) { UpdateAllTextComponents(); m_IsAtlasTextureDirty false; } } private bool TryAddCharacter(int unicode) { // 1. 加载字体面孔 FontEngineError error FontEngine.LoadFontFace(sourceFont, 90); // 90是默认DPI可调整 if (error ! FontEngineError.Success) { Debug.LogError($加载字体面孔失败: {error}); return false; } // 2. 获取字形索引 uint glyphIndex FontEngine.GetGlyphIndex((uint)unicode); if (glyphIndex 0) { // 0通常表示未找到字形 return false; } // 3. 渲染字形 Glyph glyph; error FontEngine.TryGetGlyphWithIndexValue(glyphIndex, GlyphLoadFlags.LOAD_RENDER, out glyph); if (error ! FontEngineError.Success || glyph.glyphId 0) { // 尝试另一种方式使用TryAddGlyphToTexture它会自动处理图集 // 这是更推荐的方式因为它直接处理了纹理打包 if (FontEngine.TryAddGlyphToTexture(glyphIndex, baseFontAsset.atlasPadding, GlyphPackingMode.BestShortSideFit, baseFontAsset.atlasRenderMode, m_DynamicAtlasTexture, out glyph)) { // 4. 将新字形添加到字体资产中 TMP_Character character new TMP_Character(unicode, glyph); baseFontAsset.characterTable.Add(character); // 更新字形查找表重要 baseFontAsset.UpdateGlyphLookupTable(); m_IsAtlasTextureDirty true; return true; } else { Debug.LogError($无法将字形添加到纹理: {error}); return false; } } return false; }3.4 驱动文本更新当字体资产更新后所有使用它的TextMeshProUGUI组件都需要被标记为脏以触发网格重建。private void UpdateAllTextComponents() { // 方法一遍历场景中所有使用此字体资产的TextMeshProUGUI var allTexts FindObjectsOfTypeTextMeshProUGUI(true); // true表示包含未激活的 foreach (var text in allTexts) { if (text.font baseFontAsset) { text.ForceMeshUpdate(true); // 强制立即更新网格 // 或者使用 text.SetAllDirty(); 标记脏等待Canvas更新 } } // 方法二更高效如果你能管理文本组件的引用可以维护一个列表 // 在文本组件Awake/OnEnable时注册OnDisable/OnDestroy时注销。 // 然后直接遍历这个列表进行更新。 }3.5 集成到文本显示流程最后我们需要一个机制在文本显示前确保其字符已被加载。可以创建一个DynamicText组件。[RequireComponent(typeof(TextMeshProUGUI))] public class DynamicText : MonoBehaviour { private TextMeshProUGUI m_TextComponent; private void Awake() { m_TextComponent GetComponentTextMeshProUGUI(); // 确保文本使用我们的动态字体 if (m_TextComponent.font ! DynamicFontManager.Instance.baseFontAsset) { m_TextComponent.font DynamicFontManager.Instance.baseFontAsset; } } private void Start() { // 在Start时请求字符因为文本内容可能在Awake后设置 RequestCharacters(); } public void SetText(string newText) { m_TextComponent.text newText; RequestCharacters(); } private void RequestCharacters() { if (DynamicFontManager.Instance ! null !string.IsNullOrEmpty(m_TextComponent.text)) { DynamicFontManager.Instance.RequestCharactersForText(m_TextComponent.text); } } }将DynamicText组件挂载到你的TMP文本对象上它会在初始化时和文本变化时自动向管理器请求所需的字符。4. 性能优化与高级技巧动态生成虽然强大但不当使用会导致运行时卡顿特别是添加大量新字符时。以下是关键的优化策略4.1 预加载与分批处理不要等到屏幕上弹出文本时才去加载字符。对于已知的文本内容如UI界面固定文字、章节标题可以在场景加载时、或进入某个界面之前进行预加载。// 在加载场景或进入界面时 IEnumerator PreloadFontCharacters(Liststring knownTexts) { HashSetint allChars new HashSetint(); foreach (var text in knownTexts) { foreach (char c in text) { allChars.Add((int)c); } } // 分批处理每帧添加N个避免单帧卡顿 int batchSize 10; int processed 0; foreach (int unicode in allChars) { if (!DynamicFontManager.Instance.IsCharacterAdded(unicode)) { DynamicFontManager.Instance.RequestCharacterImmediate(unicode); // 假设有立即添加的API processed; if (processed % batchSize 0) { yield return null; // 下一帧继续 } } } }4.2 纹理图集管理策略初始尺寸选择根据项目规模预估。对于手机游戏1024x1024是平衡点对于PC或主机可以考虑2048x2048起步。扩容策略当图集满时直接创建一张新的大纹理如尺寸翻倍并拷贝旧数据比复杂的“重组”更高效。因为Graphics.CopyTexture是GPU操作速度很快。多图集支持TMP Font Asset本身支持多张纹理atlasTextures数组。当一张图集满后可以创建第二张、第三张图集。这比不断扩容一张巨幅纹理更灵活但需要修改字体资产的内部逻辑以支持跨图集查询。4.3 内存与缓存持久化动态生成的字符集是运行时状态。为了提升用户体验避免每次游戏启动都重新动态生成已见过的字符需要将其持久化。// 保存 public void SaveDynamicCharacterSet() { Listint charList new Listint(m_AddedCharacters); string json JsonUtility.ToJson(new CharacterSetData { characters charList }); System.IO.File.WriteAllText(Application.persistentDataPath /dynamic_charset.json, json); } // 加载 public void LoadAndPregenerateCharacterSet() { string path Application.persistentDataPath /dynamic_charset.json; if (System.IO.File.Exists(path)) { string json System.IO.File.ReadAllText(path); CharacterSetData data JsonUtility.FromJsonCharacterSetData(json); StartCoroutine(PreloadCharactersCoroutine(data.characters)); } } [System.Serializable] private class CharacterSetData { public Listint characters; }在游戏启动时或主菜单界面调用LoadAndPregenerateCharacterSet在后台线程或分帧将字符预生成到字体图集中这样玩家进入游戏时绝大部分文字都已经就绪。4.4 针对不同平台的注意事项WebGL由于浏览器环境限制字体文件的加载和FontEngine的调用可能与Standalone平台有差异。确保字体文件通过UnityWebRequest正确加载并注意同步/异步问题。WebGL上文件系统访问受限持久化缓存可能需要使用PlayerPrefs或IndexedDB。移动端iOS/Android注意内存一张1024x1024的Alpha8纹理占用1MB内存。频繁的纹理创建和拷贝扩容会触发GC引起卡顿。务必做好预加载和缓存避免在性能关键帧如战斗场景进行动态添加。字体版权动态加载的字体文件必须确保你有分发版权。不要将商业字体直接打包进项目除非已获得授权。可以考虑使用开源字体如思源黑体、得意黑或向字体厂商购买相应的授权。5. 常见问题排查与实战心得在实际项目中你会遇到各种各样奇怪的问题。下面是我踩过的一些坑和解决方案5.1 问题动态添加的字符显示为乱码或错误字形可能原因1字体源文件不匹配。你动态加载的.ttf文件与创建基础Font Asset时使用的字体文件不是同一个系列、同一个字重如Regular、Bold。即使名字相同版本不同也可能导致字形轮廓差异。排查检查DynamicFontManager中sourceFont引用的Font对象是否与生成基础资产时选择的源文件完全一致。可能原因2DPI/字号设置不一致。FontEngine.LoadFontFace时指定的pointSize上面代码中的90参数会影响栅格化的尺寸和质量。这个值需要与创建基础字体资产时的设置匹配。排查在Font Asset Creator生成基础资产时记录下使用的Point Size通常在Generation Settings里。在运行时LoadFontFace时使用相同的值。可能原因3字符映射错误。TMP_Character创建时Unicode码点传错了或者glyph索引不对。排查在TryAddCharacter方法中添加调试日志打印出unicode和glyph.glyphId。确保glyphId不为0。5.2 问题字体边缘依然模糊可能原因1图集分辨率过低或Padding不足。即使动态添加如果初始图集分辨率设得太小如256x256或者Padding为0当字符数量增多后每个字符分到的像素依然很少且边缘可能和相邻字符像素混合。解决提高atlasResolution如1024或2048并设置合理的padding5-10像素。可能原因2纹理过滤模式。动态图集纹理的filterMode设置为Bilinear或Trilinear在文本缩放时会导致模糊。解决对于像素艺术或需要锐利边缘的UI可以尝试设置为Point无过滤。但通常Bilinear是UI文本的最佳选择。确保你的Canvas Scaler设置合理避免文本被非整数倍缩放。可能原因3抗锯齿Render Mode。在FontEngine.TryAddGlyphToTexture中我们传入了baseFontAsset.atlasRenderMode。这个模式如Smooth需要与基础资产创建时保持一致。如果基础资产用RasterHinted栅格提示模式生成而动态添加用Smooth风格会不统一。解决统一使用Smooth模式以获得高质量的平滑边缘。5.3 问题运行时添加字符导致明显卡顿可能原因单帧添加字符过多。ProcessPendingCharacters在一个循环里处理所有待处理字符如果一段新文本包含上百个生僻字主线程就会卡住。解决实现分帧处理。将ProcessPendingCharacters改造成协程每帧只处理固定数量如5-10个的字符处理完后yield return null。private IEnumerator ProcessPendingCharactersCoroutine(int charsPerFrame 5) { while (m_PendingCharacters.Count 0) { int processedThisFrame 0; while (m_PendingCharacters.Count 0 processedThisFrame charsPerFrame) { // ... 处理单个字符的逻辑 ... processedThisFrame; } m_IsAtlasTextureDirty true; yield return null; // 下一帧继续 } if (m_IsAtlasTextureDirty) { UpdateAllTextComponents(); m_IsAtlasTextureDirty false; } }在RequestCharactersForText中不要直接调用ProcessPendingCharacters()而是启动这个协程确保只有一个实例在运行。5.4 问题文本更新后新字符不显示需要鼠标划过或切换界面才显示可能原因文本组件没有及时重建Rebuild。我们更新了字体资产的图集和字符表但使用该字体的TextMeshProUGUI组件没有收到“需要重建网格”的通知。解决确保UpdateAllTextComponents方法被正确调用并且它确实能触发网格更新。ForceMeshUpdate(true)是强制立即重建。如果文本在滚动视图或其他复杂布局组中可能需要调用Canvas.ForceUpdateCanvases()来驱动整个Canvas的布局重建。更可靠的方法是直接设置text.text text.text;触发内部脏标记但这可能影响性能。最佳实践是维护一个需要更新的文本组件列表只更新受影响的组件。5.5 实战心得关于“Fallback Font”的陷阱TMP有一个强大的功能叫Fallback Font后备字体。当主字体找不到字符时会去Fallback列表里的字体寻找。这听起来是动态生成的完美补充但混用时要小心。如果你的动态字体是主字体并设置了一个包含全字符集的静态字体作为Fallback。那么当一个缺失字符出现时TMP会优先使用Fallback字体中的字符来显示而不是触发你的动态生成逻辑。因为Fallback的查询发生在字体资产的内部早于你拦截缺失字符的时机。建议在实现动态字体系统时清空或谨慎配置该动态字体资产的Fallback列表。确保缺失字符的“回退”行为由你的DynamicFontManager完全控制。你可以将Fallback用于另一种用途例如用另一个简单的英文字体作为动态中文字体的Fallback专门处理某些特殊符号但这需要精细的测试。动态生成最小字体集是一个“一劳永逸”解决TMP中文显示问题的方案它要求开发者对TMP的内部机制有更深的理解。一旦搭建成功它将极大地提升项目的文本渲染质量、减少内存开销并为多语言支持打下坚实基础。上面的代码和方案是一个起点在实际项目中你可能需要根据具体的UI框架、资源管理方式如Addressables进行适配和封装。记住充分测试是唯一标准尤其是在低端移动设备上要密切关注内存和帧率变化。
