1. 项目概述为什么中文字体在Unity里是个“老大难”如果你在Unity里用过UI尤其是TextMeshPro后面我们简称TMP那你大概率踩过中文字体的坑。这几乎是每个国内Unity开发者从新手到老鸟都绕不开的一道坎。表面上看不就是选个字体文件.ttf或.otf导进去用吗但实际操作起来你会发现一系列连环坑字体文件动辄几十MB导入Unity后Asset文件夹膨胀得吓人好不容易生成了字体Asset在编辑器里显示正常一打包Build到真机或者WebGL平台要么文字直接消失变成“口口口”要么材质球变成诡异的紫色更头疼的是为了显示几个字你不得不把包含近万个字符的巨型字体集打进去包体大小根本没法看。这些问题背后的核心原因是TMP的字体工作方式与传统的Unity UI Text有本质不同。TMP为了获得极致的渲染效果和性能采用的是“静态字体图集”技术。简单说它不是动态调用系统字体来渲染文字而是需要你预先指定一个字符集然后把所有这些字符的“样子”也就是字形烘焙到一张或多张纹理图集里运行时直接贴图显示。这对于只有几十个字母的英文来说轻而易举但对于拥有数万个汉字的中文就是一场灾难。你不可能也不应该把整个GB2312近7000字甚至GBK两万多字字符集全部烘焙进去。所以这个“完整避坑指南”要解决的就是如何科学、高效地管理TMP中文字体从字体文件的选择、导入、字符集生成到最终的资源打包与平台适配形成一套可落地、能复现的标准化流程。目标很明确让中文字体在Unity编辑器里所见即所得在打包后稳定运行并且尽可能保持最小的运行时资源占用。接下来我会结合我趟过的无数坑把这套流程掰开揉碎了讲清楚。2. 核心思路拆解从“全量烘焙”到“按需生成”在深入实操之前我们必须先扭转一个思维定式不要试图为TMP创建一个“万能”的中文字体Asset。那种包含所有常见汉字动辄十几MB的字体Asset是项目资源的“毒瘤”。正确的思路是“动态收集按需生成分而治之”。2.1 传统全量方案的弊端分析很多新手教程会教你在TMP的Font Asset Creator工具里直接选择一个中文字体文件然后在Character Set里选择Characters from File并加载一个包含几千个常用汉字的文本文件比如网上找的“3500常用字.txt”。这种方法能快速解决问题但后患无穷资源体积爆炸生成的字体Asset.asset文件及其关联的纹理图集会非常大。一个包含7000汉字的字体Asset轻松超过20MB。这还只是一个字重比如常规体如果你还需要粗体、斜体体积直接翻倍。内存占用高运行时这个巨大的字体纹理会被加载到GPU内存中。在移动端这可能会挤占其他更重要的纹理资源甚至引发内存警告。生成效率低每次修改字符集或者字体属性都需要重新烘焙这个庞然大物等待时间漫长。维护困难如果项目中后期需要新增显示几个生僻字比如用户昵称你就得重新编辑那个巨大的字符集文件重新烘焙流程繁琐且容易出错。2.2 “按需生成”方案的核心原理我们的目标是项目里最终打包的字体Asset只包含游戏真正用到的那些字符。如何知道游戏用到了哪些字符呢答案是在开发过程中动态收集。开发期收集在编辑器模式下我们通过脚本自动扫描项目中所有使用TMP组件的预制体Prefab、场景Scene、甚至代码中动态设置的文本内容提取出所有不重复的字符。生成期烘焙在打包Build前或者通过一个编辑器工具触发一个流程将收集到的字符集去重合并后传递给Font Asset Creator让它只针对这些字符生成字体纹理和Asset。运行时使用打包后的游戏只加载这个“瘦身”后的字体Asset。因为字符集最小所以纹理小、内存占用低、加载快。这个方案的关键在于“自动化”。我们需要一套编辑器工具链把收集、合并、生成、赋值的流程串联起来让开发者几乎无感地完成字体优化。下面我们就来一步步实现它。3. 工具选型与前期准备工欲善其事必先利其器。在开始编码之前我们需要明确几个关键选择。3.1 字体文件.ttf/.otf的选择不是所有字体文件都适合用于TMP生成。这里有几个硬性要求必须包含目标字符你用的字体文件里必须要有你打算显示的那些汉字。通常我们从网上下载的“思源黑体”、“方正字库”等都是完整的。推荐使用.ttf(TrueType)格式Unity和TMP对.ttf格式的支持最为稳定和广泛。.otf(OpenType) 格式虽然理论上也支持但在某些边缘情况下可能会遇到生成失败或字形错误的问题为了减少不确定性首选.ttf。确认字体版权这是商业项目必须严肃对待的一环。务必确保你使用的字体获得了相应的授权。许多开源字体如思源黑体系列、得意黑等是免费商用的是安全的选择。实操心得我会在项目的Assets/Plugins或Assets/Resources文件夹下创建一个Fonts子目录专门存放原始的.ttf字体文件。并为其创建一个独立的README.md注明字体名称、来源、授权协议方便团队协作和日后排查。3.2 理解TMP的核心资产Font Asset 和 Material生成后的TMP字体会产出两个核心资产理解它们的关系至关重要Font Asset (.asset文件)这是核心数据文件。它记录了字符到纹理UV的映射关系即哪个字在纹理图的哪个位置、字体的度量信息如 ascent, descent, line height、以及默认关联的材质球引用。Material (.mat文件)这是渲染用的材质球使用TMP自带的TextMeshPro/Distance Field或TextMeshPro/Mobile/Distance Field等Shader。材质球上引用了上一步生成的字体纹理图集。一个常见的巨坑就发生在这里你生成了Font Asset但在打包后TMP组件找不到它该用的材质球于是渲染成紫色。这通常是因为材质球没有正确被打包进资源包如AssetBundle或者Font Asset中对材质球的引用在打包过程中丢失了。我们后续的流程会重点解决这个问题。4. 实操流程构建自动化字体管理系统接下来是重头戏我们将创建一个编辑器窗口工具来实现“按需生成”的全流程。4.1 第一步创建字符收集器Character Collector我们需要一个脚本能够遍历项目中的文本资源提取字符。// CharacterCollector.cs using UnityEngine; using UnityEditor; using TMPro; using System.Collections.Generic; using System.IO; using System.Text; public class CharacterCollector : EditorWindow { [MenuItem(Tools/TMP Font/Collect Characters)] static void CollectCharactersInProject() { HashSetchar characterSet new HashSetchar(); // 1. 收集场景中的TMP文本 TMP_Text[] textsInScenes Resources.FindObjectsOfTypeAllTMP_Text(); foreach (var text in textsInScenes) { if (!string.IsNullOrEmpty(text.text)) { foreach (char c in text.text) { // 过滤掉基本ASCII控制字符和空白符但保留空格\u0020 if (!char.IsControl(c) c ! \uFEFF) // 排除BOM头 { characterSet.Add(c); } } } } // 2. 收集Prefab中的TMP文本即使Prefab未放入场景 string[] prefabGuids AssetDatabase.FindAssets(t:Prefab); foreach (string guid in prefabGuids) { string path AssetDatabase.GUIDToAssetPath(guid); GameObject prefab AssetDatabase.LoadAssetAtPathGameObject(path); if (prefab ! null) { TMP_Text[] textsInPrefab prefab.GetComponentsInChildrenTMP_Text(true); // true表示包含未激活的 foreach (var text in textsInPrefab) { if (!string.IsNullOrEmpty(text.text)) { foreach (char c in text.text) { if (!char.IsControl(c) c ! \uFEFF) { characterSet.Add(c); } } } } } } // 3. 可选收集代码中可能用到的字符串例如本地化键值 // 这里可以扩展读取你的本地化CSV或JSON文件 // 4. 将字符集排序并保存到文本文件 Listchar sortedList new Listchar(characterSet); sortedList.Sort(); StringBuilder sb new StringBuilder(); foreach (char c in sortedList) { sb.Append(c); } string outputPath Assets/Generated/TMP_CharacterSet.txt; Directory.CreateDirectory(Path.GetDirectoryName(outputPath)); File.WriteAllText(outputPath, sb.ToString(), Encoding.UTF8); AssetDatabase.Refresh(); Debug.Log($字符收集完成共收集到 {characterSet.Count} 个唯一字符。已保存至{outputPath}); // 5. 自动打开下一步的字体生成窗口 FontAssetGeneratorWindow.ShowWindow(outputPath); } }注意事项Resources.FindObjectsOfTypeAll会找到所有加载的资源包括未激活的但它不会加载未引用的、未在编辑器中打开的Prefab。因此我们额外遍历了所有Prefab文件。这个收集器是基础版。一个健壮的系统还应考虑脚本ableObject中的文本、Addressables系统中的资源、以及通过网络下载的动态文本的“预知”可以通过一个“预留字符”配置文件来补充。生成的字符集文件建议放在Assets/Generated或Assets/Resources这类容易被版本管理工具如Git忽略或特殊处理的文件夹内因为它是一个频繁变动的派生文件。4.2 第二步创建字体Asset生成器Font Asset Generator有了字符集文件我们现在需要利用TMP的API来生成字体Asset。// FontAssetGeneratorWindow.cs using UnityEngine; using UnityEditor; using TMPro; using System.IO; public class FontAssetGeneratorWindow : EditorWindow { private static string characterFilePath; private Font sourceFont; private int fontSize 72; // 推荐值影响生成纹理的清晰度 private int padding 5; // 字符间的内边距 private int atlasWidth 1024; // 图集宽度 private int atlasHeight 1024; // 图集高度 private string assetName MySDFFont; public static void ShowWindow(string charFilePath) { characterFilePath charFilePath; FontAssetGeneratorWindow window GetWindowFontAssetGeneratorWindow(生成TMP字体Asset); window.Show(); } void OnGUI() { GUILayout.Label(源字体设置, EditorStyles.boldLabel); sourceFont (Font)EditorGUILayout.ObjectField(源字体文件 (.ttf), sourceFont, typeof(Font), false); GUILayout.Space(10); GUILayout.Label(生成参数, EditorStyles.boldLabel); fontSize EditorGUILayout.IntField(字体大小 (px), fontSize); padding EditorGUILayout.IntField(内边距 (px), padding); atlasWidth EditorGUILayout.IntField(图集宽度, atlasWidth); atlasHeight EditorGUILayout.IntField(图集高度, atlasHeight); assetName EditorGUILayout.TextField(生成Asset名称, assetName); GUILayout.Space(20); if (GUILayout.Button(生成SDF字体Asset, GUILayout.Height(40))) { if (sourceFont null) { EditorUtility.DisplayDialog(错误, 请选择源字体文件, 确定); return; } if (!File.Exists(characterFilePath)) { EditorUtility.DisplayDialog(错误, $字符集文件不存在: {characterFilePath}, 确定); return; } GenerateFontAsset(); } // 显示字符集信息 if (File.Exists(characterFilePath)) { GUILayout.Space(10); string charContent File.ReadAllText(characterFilePath); EditorGUILayout.HelpBox($将使用字符集文件: {characterFilePath}\n字符数量: {charContent.Length}, MessageType.Info); } } void GenerateFontAsset() { // 读取字符集 string characterSet File.ReadAllText(characterFilePath); // 配置Font Asset Creator TMPro_FontAssetCreator fontAssetCreator new TMPro_FontAssetCreator(); TMPro.FontAssetCreationSettings settings new TMPro.FontAssetCreationSettings(); settings.sourceFontFile sourceFont; settings.sourceFontSize fontSize; settings.padding padding; settings.atlasWidth atlasWidth; settings.atlasHeight atlasHeight; settings.characterSet characterSet; settings.renderMode TMPro.FontAssetCreationRenderMode.DistanceField16; // 使用16级距离场质量和性能平衡 settings.referencedTextAsset null; // 我们直接使用字符集字符串 // 设置输出路径 string outputFolder Assets/Generated/FontAssets/; Directory.CreateDirectory(outputFolder); string fontAssetPath outputFolder assetName .asset; string materialPath outputFolder assetName _Material.mat; // 执行生成 bool success fontAssetCreator.CreateFontAsset(settings, fontAssetPath, materialPath); if (success) { Debug.Log($字体Asset生成成功\nFont Asset: {fontAssetPath}\nMaterial: {materialPath}); // 加载生成的Asset并设置一些推荐属性 TMP_FontAsset fontAsset AssetDatabase.LoadAssetAtPathTMP_FontAsset(fontAssetPath); if (fontAsset ! null) { // 设置行高这是一个经验值通常为字体大小的1.2-1.5倍 fontAsset.faceInfo.lineHeight fontSize * 1.4f; // 标记为脏让Unity保存更改 EditorUtility.SetDirty(fontAsset); } AssetDatabase.Refresh(); EditorUtility.DisplayDialog(完成, 字体Asset生成成功, 确定); } else { Debug.LogError(字体Asset生成失败请检查参数和字符集。); EditorUtility.DisplayDialog(错误, 生成失败请查看控制台日志。, 确定); } } }核心参数解析与避坑指南字体大小 (Font Size)这个值不是运行时显示的字体大小而是生成距离场SDF纹理时的采样精度。值越大生成的字符轮廓越精细抗锯齿效果越好但纹理尺寸也会相应增加因为要容纳更多细节。对于大多数UI字体72是一个在质量和纹理尺寸间取得良好平衡的起点。如果你需要显示非常大的字如标题可以考虑提高到90或120。图集尺寸 (Atlas Width/Height)这是生成的纹理图片的尺寸。如果字符集很大一张1024x1024的图可能放不下TMP会自动创建多张图集Atlas Textures。关键点来了这里设置的尺寸是每张图集的尺寸。不是越大越好需要根据目标平台调整。移动端建议从512或1024开始PC端可以考虑2048。你需要观察生成日志确保没有字符因为图集放不下而被丢弃。渲染模式 (Render Mode)DistanceField16是最常用的选项。它生成一张16位精度的距离场纹理在缩放和动态光照下都有很好的表现。RasterHinted模式生成的是位图缩放会模糊不推荐用于可变大小的UI文本。生成后的检查生成成功后务必在Inspector中检查生成的Font Asset。重点看Atlas Population Mode是否为Static以及Character Table里是否包含了所有你预期的字符。如果字符缺失说明图集尺寸或内边距设置不合理需要调整参数重新生成。4.3 第三步自动化赋值与打包保障生成了新的字体Asset后我们还需要让项目中所有使用旧字体或默认字体的TMP组件自动更新引用到新生成的字体上。同时要确保打包时资源依赖关系正确。// FontAssetAssigner.cs using UnityEngine; using UnityEditor; using TMPro; using System.Collections.Generic; public class FontAssetAssigner { [MenuItem(Tools/TMP Font/Assign Font to All TMP Texts)] static void AssignFontToAllTexts() { // 让用户选择新生成的Font Asset string fontAssetPath EditorUtility.OpenFilePanel(选择TMP Font Asset, Assets/, asset); if (string.IsNullOrEmpty(fontAssetPath)) return; // 将绝对路径转换为相对于项目的路径 fontAssetPath Assets fontAssetPath.Substring(Application.dataPath.Length); TMP_FontAsset newFontAsset AssetDatabase.LoadAssetAtPathTMP_FontAsset(fontAssetPath); if (newFontAsset null) { Debug.LogError(选择的文件不是有效的TMP_FontAsset。); return; } // 查找并替换所有TMP_Text组件的字体引用 TMP_Text[] allTexts Resources.FindObjectsOfTypeAllTMP_Text(); int replacedCount 0; foreach (TMP_Text text in allTexts) { // 跳过未保存的Prefab实例等 if (EditorUtility.IsPersistent(text.gameObject)) continue; Undo.RecordObject(text, Assign TMP Font); text.font newFontAsset; replacedCount; // 如果该组件使用了Font Shared Material也一并更新通常关联更新 // text.fontSharedMaterial 通常会自动关联到新字体的默认材质 } Debug.Log($已将字体 {newFontAsset.name} 分配给 {replacedCount} 个TMP_Text组件。); AssetDatabase.SaveAssets(); // 保存场景和预制体的更改 } // 这是一个预构建脚本示例用于确保字体Asset及其材质被打包 public class BuildPreprocessor : IPreprocessBuildWithReport { public int callbackOrder { get { return 0; } } public void OnPreprocessBuild(UnityEditor.Build.Reporting.BuildReport report) { Debug.Log(开始构建前检查TMP字体资源...); // 这里可以添加检查逻辑例如 // 1. 确保关键的Font Asset被标记为“Always Include”或存在于Resources文件夹或被场景/预制体引用。 // 2. 检查Font Asset的材质引用是否有效。 // 3. 对于使用AssetBundle的项目确保字体Asset被打包到正确的Bundle中。 // 一个简单的检查查找所有TMP_FontAsset确认其默认材质是否有效。 string[] fontAssetGuids AssetDatabase.FindAssets(t:TMP_FontAsset); foreach (string guid in fontAssetGuids) { string path AssetDatabase.GUIDToAssetPath(guid); TMP_FontAsset font AssetDatabase.LoadAssetAtPathTMP_FontAsset(path); if (font ! null font.material null) { Debug.LogWarning($发现字体Asset {font.name} 的默认材质引用丢失路径{path}。这可能导致打包后文字显示为紫色。请重新生成或手动指定材质。); } } } } }打包避坑核心字体Asset在打包后“消失”或材质变紫99%的原因是资源依赖链断裂。对于直接构建非AssetBundle确保你的字体Asset.asset文件和其材质球.mat文件至少被一个打包场景Build Settings里的Scenes中的某个对象直接或间接引用。最保险的做法是创建一个空的Prefab或ScriptableObject引用这个字体Asset然后把这个资源放在Resources文件夹下如果不介意初始包体大小或者确保它被某个必定会打包的场景中的对象引用。对于AssetBundle你需要明确将字体Asset和其材质球打到一个AssetBundle中并且确保加载UI的代码在加载UI AssetBundle之前或同时加载了包含字体资源的AssetBundle。Unity的依赖系统有时在复杂Bundle关系中会出错手动管理字体资源的Bundle归属更稳妥。5. 高级策略与疑难杂症排查掌握了基础流程我们再来看看一些进阶场景和常见问题的解法。5.1 动态文本与“缺字”处理我们的“按需生成”方案基于静态分析。但如果游戏中有大量完全动态的文本如玩家聊天、用户生成内容我们无法在打包前预知所有字符。这时需要“动态字体回退”或“动态字体补充”机制。方案A动态SDF生成不推荐在运行时根据收到的文本动态生成包含新字符的字体纹理。这在WebGL或移动端性能开销极大且实现复杂极易造成卡顿和内存碎片。方案B字体回退链推荐这是TMP内置的优雅解决方案。创建多个字体Asset。Font_Common包含最常用的1000-2000汉字。创建Font_Extra1Font_Extra2等包含一些不那么常用但可能出现的字符如生僻字、特殊符号。在Font_Common的Inspector中找到Fallback Font Asset Table列表将Font_Extra1,Font_Extra2等添加进去。运行时如果一个字符在Font_Common中找不到TMP会自动在回退链中的下一个字体Asset里查找。你需要确保回退字体Asset也被正确打包和加载。实操心得回退链不要设置得太深一般2-3层足矣并且要确保回退字体Asset的材质Shader设置与主字体一致否则会出现渲染风格不统一的问题。5.2 WebGL与移动端特殊优化纹理格式在Player Settings中为你生成的字体纹理图集选择合适的压缩格式。对于移动端ASTC或ETC2是不错的选择对于WebGL由于浏览器兼容性通常使用RGBA32无压缩或DXT5如果支持。不恰当的压缩会导致字体边缘出现严重锯齿或模糊。图集尺寸与内存移动端内存紧张务必监控字体纹理的内存占用。使用上文提到的“按需生成”是根本。此外如果生成了多张图集考虑是否可以通过调整Padding和Atlas Size来减少图集数量。Addressables系统如果你的项目使用了Addressables字体Asset和材质球必须与使用它们的UI预制体放在同一个AssetBundle Group中或者明确声明其依赖关系。否则异步加载UI时字体资源可能尚未就绪。一个可靠的做法是将字体Asset及其材质打成一个独立的、被预加载的AssetBundle。5.3 常见问题排查速查表问题现象可能原因排查步骤与解决方案编辑器正常打包后文字不显示空白或方块1. 字体Asset未被打包。2. 字体Asset的材质球引用丢失打包后材质球为None。1. 检查字体Asset是否被任何打包场景中的对象引用。可在Build后查看Console中关于“Unused Assets”的日志需开启详细日志。2. 在编辑器中选择字体Asset查看其Default Material是否有效。无效则需重新生成或手动指定正确的材质球。确保材质球也被打包。文字显示为紫色粉红色Shader错误或材质球丢失。这是TMP材质球丢失的典型表现。1. 检查字体Asset的Default Material。2. 检查具体TMP组件上Font Material的引用。可能是覆盖了默认材质且该材质丢失。3. 检查目标平台的Graphics API设置以及材质球使用的Shader是否支持该平台TMP Shader通常支持。字体边缘模糊、有锯齿1. 生成Font Asset时Font Size采样大小设置过低。2. 纹理压缩格式导致精度损失。3. Canvas的Render Mode或Scale Factor设置不当。1. 重新生成Font Asset提高Font Size如从72提高到90。2. 在字体纹理的导入设置中尝试使用更高质量或无压缩的纹理格式。3. 检查Canvas的Render Mode是否为Screen Space - Overlay并检查Scale Factor是否合理。包体中字体资源体积过大1. 字符集包含过多无用字符。2. 图集尺寸过大或生成了过多张图集。3. 纹理未压缩。1. 使用更精确的字符收集脚本剔除无用字符。2. 尝试调整Padding和Atlas Size在保证字符不丢失的前提下减少图集数量。3. 应用平台推荐的纹理压缩格式。动态加载的UI字体显示异常字体Asset所在的AssetBundle未加载或加载顺序晚于UI。1. 确保字体Asset的Bundle先于UI Bundle加载。2. 使用Addressables时将字体Asset与依赖它的UI预制体设置到同一个资源组或建立明确的依赖关系。6. 完整工作流整合与最佳实践最后我们把所有步骤串联起来形成一个高效、可重复的团队工作流项目初期在Assets/Plugins/Fonts下放置获得授权的.ttf字体文件。运行一次Collect Characters工具收集初期UI预制体和场景中的字符生成一个基础字体Asset如Font_Base。日常开发所有UI美术和策划在制作Prefab或设置文本时都使用Font_Base。当需要新增文本内容时直接使用即可。如果新增的字符在Font_Base中不存在在编辑器模式下TMP可能会显示为空白或使用回退字体如果你设置了。这是正常的开发期状态。打包前或定期运行Collect Characters工具重新扫描全项目生成最新的字符集文件。打开Font Asset Generator工具使用最新的字符集和相同的源字体生成新的字体Asset可以覆盖旧的Font_Base或使用版本号命名如Font_v2。运行Assign Font to All TMP Texts工具将项目中所有TMP文本的字体引用更新到新生成的Asset上。进行一次测试构建在目标平台如Android真机上验证所有文字显示正常。处理动态文本提前分析可能出现的生僻字范围如二级汉字库生成一个Font_Fallback资源并在Font_Base中将其设置为回退字体。这套流程的核心思想是将字体管理自动化、流程化将其从一项容易出错的“黑盒”操作转变为团队可视、可控的常规构建步骤。它彻底解决了中文字体在Unity TMP中的打包顽疾将包体大小和内存占用控制在合理范围内同时保证了跨平台的稳定性。