1. 项目概述：从“口口口”到清晰中文的救赎之路
如果你在Unity里用过TextMeshPro（TMP），那对满屏的“口口口”或者豆腐块（□）肯定不陌生。这几乎是每个涉及中文的Unity项目在初期都会遇到的“入门礼”。问题根源很简单：TMP默认的字体资源（Font Asset）里没有包含中文字形。网上教程很多，但要么步骤不全，要么给的字符集文件（Character Set）不实用，导致你跟着做了一遍，游戏里该乱码的还是乱码，或者只显示了一部分字。今天，我就以一个踩过无数坑的过来人身份，手把手带你用Unity自带的Font Asset Creator工具，彻底解决这个问题。我会附上一个精心整理、覆盖了7000+常用汉字的字符集文件，确保你的游戏UI能应对绝大多数中文场景。这不是一个简单的“点击生成”教程，我会深入每一步背后的原理，告诉你为什么这么做，以及哪些细节能让你事半功倍。
2. 核心原理：为什么TMP对中文如此“挑剔”？
在动手之前，我们必须搞清楚敌人是谁。TMP之所以强大，是因为它使用了Signed Distance Field（SDF，有向距离场）技术来渲染文字。与传统位图字体不同，SDF字体将每个字符的形状信息存储为一张灰度图，图中每个像素的值代表了该点到字符轮廓边界的距离（内部为正，外部为负）。这种技术让字体在任意缩放时都能保持边缘锐利，且能方便地实现描边、发光等特效。
2.1 字体资产（Font Asset）的本质
一个TMP的Font Asset文件，本质上是一个“字形图集（Glyph Atlas）+ 映射表”的打包体。
- 字形图集：工具会根据你提供的字符集（Character Set），从指定的.ttf或.otf字体文件中，提取这些字符的轮廓信息，然后为每个字符生成SDF数据，并将所有字符的SDF纹理打包到一张或几张大的纹理图集中。
- 映射表：一个数据结构，记录了每个Unicode字符对应在图集中的哪个位置（UV坐标）、大小、偏移量等渲染信息。
当你使用TMP Text组件显示“你好”时，引擎会去查找Font Asset中的映射表，找到“你”和“好”对应的图集位置，然后从图集纹理中采样SDF数据进行渲染。
2.2 中文乱码的根源
默认情况下，Unity创建TMP Font Asset时，使用的字符集通常是ASCII基础字符（0-127）或TMP自带的动态字体补充集（Dynamic），这些集合里汉字寥寥无几。如果你的文本中包含了一个Font Asset映射表里不存在的字符，TMP就无法找到对应的字形信息，于是就用一个“缺失字形”（Missing Glyph）来代替，也就是我们看到的“口口口”或方块。
所以，解决问题的核心逻辑非常清晰：我们必须创建一个包含了所有所需中文字符的、完整的Font Asset。
注意：这里有一个关键选择——是使用“动态字体（Dynamic Font）”还是“静态字体（Static Font）”。动态字体允许在运行时从系统字体动态添加字符，看似方便，但在WebGL、移动端等平台极易因字体缺失或授权问题导致显示异常或崩溃。对于商业项目，强烈推荐使用静态字体，即将所有用到的字符提前“烘焙”到Font Asset中，这样发布后字体渲染不再依赖任何系统字体，100%可控。我们接下来的教程就是基于静态字体方案。
3. 工具与材料准备：工欲善其事，必先利其器
解决这个问题，我们主要依靠Unity内置的Font Asset Creator工具。它藏在Window > TextMeshPro > Font Asset Creator。打开它，你会看到一个包含多个设置面板的窗口。
3.1 字体文件的选择与考量
首先你需要一个.ttf或.otf格式的中文字体文件。这里有几个关键原则：
- 版权！版权！版权！这是首要红线。切勿在商业项目中使用未获授权的字体。系统自带的字体（如Windows的“微软雅黑”、macOS的“PingFang SC”）通常不允许嵌入商业软件分发。你需要使用明确标榜可免费商用或已购买商用授权的字体。例如“思源黑体”（Source Han Sans）、“得意黑”（Smiley Sans）等都是优秀的开源可商用字体。
- 字体风格匹配项目：选择与你的游戏美术风格协调的字体。一个卡通游戏用宋体会很怪异。
- 字重（Font Weight）：常规体（Regular）、中等（Medium）、粗体（Bold）等。建议至少准备常规体和粗体，分别用于正文和标题。
实操建议：在项目内创建一个Fonts文件夹，将合法获取的字体文件放入其中。例如，我选择使用“思源黑体 Regular”（SourceHanSansSC-Regular.otf）。
3.2 核心：7000+常用汉字字符集文件
这是本教程的干货之一。网上很多教程给的字符集是“常用3500字”，但在实际游戏中，角色名、物品描述、剧情对话很容易用到超出这个范围的字。我根据现代汉语语料库频率，结合多年游戏开发经验，整理了一个包含7000+高频汉字的字符集文件。这个集合覆盖了99.9%的日常使用和游戏叙事场景，能极大避免“缺字”尴尬。
这个字符集是一个.txt文本文件，内容就是一连串的汉字。你可以通过以下方式使用它：
- 在Font Asset Creator的
Character Set选项中选择Custom Characters。 - 将整个文本文件的内容复制粘贴到下方的文本框中。
为了方便，我也会说明如何自己从一份文本（如游戏剧本）中自动提取所有不重复的汉字来生成专属字符集，这对于文本量固定的项目是最优解。
4. Font Asset Creator 参数详解与实战配置
打开Font Asset Creator，面对一堆参数不要慌，我们逐一拆解。下图展示了关键配置区域的关系：
（想象一个配置流程图：源字体 -> 字符集 -> 生成设置 -> 输出资产）
4.1 Source Font File 与 Face Style
- Source Font File：点击
Select，选择你准备好的中文字体文件（如SourceHanSansSC-Regular.otf）。 - Sampling Point Size：采样点大小。这个值非常重要，它决定了SDF纹理生成时的基础分辨率。值越大，字形细节越丰富，但纹理尺寸也会暴涨。对于UI常用字号（如24pt-48pt），设置为72是一个很好的平衡点。如果你需要显示非常大的字（如标题），可以考虑提高到
96甚至144。 - Padding：内边距。每个字形在图集中周围的空白像素。至少设置为5，以防止渲染时相邻字形的SDF距离场互相干扰导致边缘瑕疵。如果设置了描边或发光效果，需要酌情增加（如设为
8或10）。
4.2 Character Set：注入灵魂的一步
- 选择模式：在下拉框中选择
Custom Characters。 - 自定义字符框：将我提供的7000+汉字字符集全文粘贴进去。你可以先点击右下角的
Clear清空默认内容。重要检查：粘贴后，务必滚动检查末尾，确保没有多余的换行符或空格。有时从某些编辑器复制会带上看不见的格式字符。
4.3 Render Mode 与 Atlas Resolution
- Render Mode：保持默认的
SDF即可。SDFAA（抗锯齿）模式更柔和，但性能开销略高，且对非常小的字效果更好，UI字体通常用SDF就够了。 - Atlas Resolution：图集分辨率。这是另一个关键参数。7000多个汉字，如果每个字都按72大小生成，需要的纹理面积非常大。工具会自动尝试将字形打包进你指定尺寸的图集。如果尺寸太小，它会自动创建多个图集（即多个纹理文件）。
- 建议策略：先从
1024 x 1024开始尝试点击Generate Font Atlas预览。如果左下角状态显示“成功打包到1张纹理”，且Packing结果显示利用率较高（如80%以上），那么这个尺寸就合适。 - 如果显示需要2张或更多纹理，你可以考虑适当增大尺寸到
2048 x 2048。但需要权衡：移动端GPU对纹理尺寸有要求（如很多低端机最大支持2048），且过大的纹理占用内存多。对于7000字库，2048x2048通常能打包进一张纹理，是桌面和主流移动端的理想选择。如果2048还不行，可以尝试稍微降低Sampling Point Size到64。
- 建议策略：先从
4.4 其他高级设置
- Character List和Glyph Render Mode：保持默认。
- Get Kerning Pairs：勾选。字距调整对中文排版也很重要，能让字与字之间的间距更均匀美观。
5. 生成、优化与使用流程实录
5.1 首次生成与问题排查
- 配置好所有参数（字体文件、粘贴7000字字符集、采样72、内边距5、图集2048）。
- 点击右下角的
Generate Font Atlas按钮。状态栏会显示“Generating font atlas...”，然后显示打包结果。 - 成功状态：如果看到预览窗口显示了密密麻麻的汉字网格，并且状态显示“Font atlas generation completed in ...”，左下角显示“Successfully packed into 1 texture atlas”，恭喜你，第一步成功了。
- 常见失败与解决：
- “Failed to read font file...”：检查字体文件路径是否包含中文或特殊字符，尝试将字体文件放到更简单的英文路径下。或者字体文件本身已损坏。
- 打包失败，字形溢出：如果提示无法打包进指定尺寸的图集，要么增大
Atlas Resolution，要么减少Sampling Point Size，要么检查字符集是否包含了过多巨大字符（某些特殊符号）。 - 预览空白或只有部分字：检查自定义字符框，可能粘贴时字符丢失或格式错误。尝试换一个纯文本编辑器（如Notepad++）复制粘贴。
5.2 保存与优化字体资产
生成预览无误后：
- 点击
Save或Save as...按钮。 - 在弹出的保存对话框中，建议命名为一个易于识别的名字，例如
FontAsset_SourceHanSans_SC_Regular_72pt。同时，务必将其保存在项目的Resources文件夹或其子文件夹下。因为TMP默认会从Resources文件夹加载字体资产。一个常见的结构是：Assets/Resources/Fonts & Materials/。 - 保存后，你会得到两个文件：一个
.asset文件（字体资产）和一个或多个.png文件（纹理图集）。检查纹理图集的导入设置（Inspector），确保Texture Type为Default，并且根据平台需要设置压缩格式（如Android用ASTC，iOS用PVRTC）。
5.3 在项目中使用自定义字体资产
- 在场景中创建一个TMP Text对象（GameObject -> UI -> Text - TextMeshPro）。
- 在它的
TextMeshPro - Text (UI)组件上，找到Font Asset属性。 - 将你刚刚保存的字体资产拖拽赋值给它。
- 在
Text输入框中输入中文，例如“魑魅魍魉”，如果这些字都在你的7000字库中，它们应该都能正确显示，不再有乱码。
5.4 为不同字重创建字体资产
一个完整的UI系统通常需要常规体和粗体。重复上述过程：
- 选择粗体字体文件（如
SourceHanSansSC-Bold.otf）。 - 可以使用完全相同的7000字字符集。
- 生成并保存为另一个字体资产，命名为
FontAsset_SourceHanSans_SC_Bold_72pt。 - 在TMP Text组件中，你可以通过
Font Asset属性直接切换，更规范的做法是创建一个TMP Font Asset Material Variant来管理不同样式。
6. 进阶技巧与深度优化
6.1 动态生成专属最小字符集
对于文本内容固定的项目（如单机剧情游戏），为所有对话文本生成一个最小字符集是最优解，能最大程度减小字体资产大小。
- 提取所有文本：将游戏内所有需要显示的文本（JSON、XML、Excel表）合并到一个大文本文件中。
- 编写简单脚本去重：可以用Python或C#写一个小工具，读取这个大文本，过滤掉非中文字符，然后去重。
# Python示例：extract_chars.py import re with open('all_game_text.txt', 'r', encoding='utf-8') as f: content = f.read() # 使用正则表达式匹配所有汉字 chinese_chars = re.findall(r'[\u4e00-\u9fff]', content) # 去重并排序 unique_chars = sorted(set(chinese_chars)) # 写入文件 with open('custom_character_set.txt', 'w', encoding='utf-8') as f: f.write(''.join(unique_chars)) print(f'提取了 {len(unique_chars)} 个不重复汉字。') - 将生成的
custom_character_set.txt内容用于Font Asset Creator。
6.2 字体资产内存与性能管理
- 纹理尺寸与数量：时刻关注生成的纹理图集数量和尺寸。一张2048x2048的RGBA32纹理占用约16MB内存（未压缩）。多个图集会线性增加内存消耗。在移动设备上，这是需要重点优化的部分。
- 按需分拆：如果你的游戏有大量UI，但不同界面用字差异很大，可以考虑创建多个字体资产。例如，主菜单字体资产包含所有菜单文字，战斗伤害数字字体资产只包含数字和少数符号。这样可以避免单个字体资产过大。
- 禁用不需要的字体特性：在字体资产的Inspector中，检查
Atlas Population Mode是否为Static，并确认Dynamic选项已禁用，确保它是纯粹的静态字体。
6.3 与Unity版本和TMP版本的兼容性
不同版本的Unity和TMP包，Font Asset Creator的界面和功能可能有细微差别。本教程基于较新的版本（如Unity 2022 LTS + TMP 3.x）。如果遇到界面不同，核心逻辑（指定字体、提供字符集、生成图集）是不变的。
7. 常见问题排查与解决方案速查表
即使按照步骤操作，你可能还是会遇到一些奇怪的问题。下面这个表格是我和同事们多年积累的“血泪史”总结：
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 生成了字体资产，但游戏中部分字仍是“口” | 1. 字符集确实不包含该字。 2. 字体文件本身缺少该字的字形（某些字体不全）。 3. 文本中包含全角空格等不可见字符。 | 1. 检查该字是否在7000字库中，若为生僻字需手动添加。 2. 换一个更完整的字体文件试试。 3. 检查文本字符串，在代码中打印其Unicode值。 |
| 字体边缘有锯齿或毛刺 | 1.Sampling Point Size设置过低。2. Padding值太小，SDF距离场在边缘采样时发生插值错误。3. 纹理压缩导致精度损失。 | 1. 适当提高采样点大小（如72->96）。 2. 增加Padding值（如5->8）。 3. 尝试使用更高质量的纹理压缩格式，或暂时禁用压缩进行测试。 |
| 字体在游戏运行时突然全部消失 | 1. 字体资产没有放在Resources文件夹下，且未通过代码动态加载。2. 字体资产或材质球被意外卸载。 | 1. 确保字体资产在Resources目录中，或使用Resources.Load或Addressables确保其被正确引用和加载。2. 检查场景引用，避免动态实例化时材质丢失。 |
| 打包后（尤其是移动端）中文不显示 | 1. 字体资产或纹理图集没有被包含在构建中。 2. 移动端纹理尺寸超限或被错误压缩。 3. 使用了动态字体，但目标设备没有对应中文字体。 | 1. 检查字体资产和纹理的导入设置，确保在目标平台被包含。 2. 检查纹理尺寸是否符合目标平台限制（如OpenGL ES 2.0设备可能不支持2048以上纹理）。 3.坚决使用静态字体方案，杜绝此问题。 |
| Font Asset Creator 生成过程卡死或崩溃 | 1. 字符集过大（超过数万）。 2. 字体文件异常。 3. Unity或系统内存不足。 | 1. 尝试分批次生成字符集。 2. 更换字体文件。 3. 关闭其他程序，重启Unity。 |
| 文字描边或发光效果异常 | 1. 字体资产的材质球（Material）设置问题。 2. SDF的 Dilate参数需要调整。 | 1. 不要直接修改TMP自带的材质，应通过字体资产创建材质变体（Material Preset）进行修改。 2. 在Font Asset Creator生成时，可以调整 Dilate值来影响SDF的“厚度”，从而影响特效范围。 |
最后的心得：处理TMP中文问题，耐心和细心是关键。第一次配置可能会花些时间，但一旦建立起可靠的静态字体资产管线，后续就是重复性的高效工作了。那个7000+字库是我多个项目验证过的安全网，建议你以此为基础，再根据项目特殊需求（如特定NPC名字、技能名）进行增补。记住，在UI美术设计初期，就和他们确定好要使用的字体和字号范围，并在开发早期就生成好字体资产进行测试，能避免后期大量文本返工。
