企业官网建设流程全解析

1. 项目概述：为什么Unity中文显示是个“老大难”？

在Unity里做中文项目，尤其是涉及到大量文本的UI、剧情或者本地化内容时，开发者十有八九都踩过“口口口”或者显示空白的坑。这问题看似简单，实则背后牵扯到字体资源、渲染管线、字符编码和引擎版本兼容性等一系列技术细节。Unity自带的UI Text组件在早期版本对中文支持就非常孱弱，而后来官方主推的TextMeshPro（简称TMP）虽然功能强大，但如果不做特殊处理，默认的字体资源（SDF Atlas）里根本找不到几个中文字符，直接使用的结果就是大部分中文都显示不出来。

我最近在Unity 2023.2下接手了一个需要显示大量、多样中文文本的项目，从古籍诗词到现代网络用语都有涉及。默认的TMP字体Asset只能显示几百个常用字，远远不够用。经过一番折腾，我最终通过生成一个包含近7000个常用及次常用汉字的自定义字库，实现了稳定、高效且美观的中文显示。这个过程里，从字库选择、工具使用到性能优化，每一步都有不少门道。这篇文章，我就把这次实战的经验、踩过的坑和最终的解决方案，毫无保留地分享出来。无论你是正在被中文显示问题困扰的开发者，还是想提前为项目做好本地化准备的同行，相信都能从中找到答案。

2. 核心思路与方案选型：为什么是TextMeshPro + 自定义字库？

面对中文显示问题，通常有几个备选方案：继续用旧版UI Text并搭配系统字体、使用Asset Store里的第三方中文字体插件，或者深耕TextMeshPro的自定义字库方案。我最终选择了第三条路，原因如下：

2.1 方案对比与取舍

• 传统UI Text + 系统字体：这是最“偷懒”的方法，直接把操作系统里的中文字体（如思源黑体、微软雅黑）拖到Font字段。它的优点是简单，能显示所有系统支持的字符。但缺点致命：性能差，每个文本对象都是单独绘制调用（Draw Call），UI一复杂，Draw Call数就爆炸；效果单一，不支持TMP丰富的富文本标签（如颜色渐变、字距调整、材质效果）；兼容性噩梦，在不同操作系统（Windows/macOS）甚至不同设备（PC/移动端）上，可能因为字体缺失或版本差异导致显示不一致或乱码。
• 第三方字体插件：Asset Store上有一些打包好的中文字体Asset，或者动态字体加载工具。它们省去了自己生成字库的步骤。但缺点也很明显：灵活性差，插件提供的字符集是固定的，可能不符合你项目的特殊用字需求（比如一些生僻字、古汉字或特殊符号）；更新麻烦，如果发现缺字，你很难自己去修改插件生成的字库；可能有授权风险，需要仔细检查插件所用字体的版权协议是否允许商业发行。
• TextMeshPro自定义字库：这是官方推荐且能力最强的方案。你需要自己准备一个字体文件（.ttf或.otf），然后使用Unity的TextMeshPro Font Asset Creator工具，从中提取你需要的字符，生成一个TMP专用的字体Asset（.asset文件）和对应的纹理图集（.png）。这个方案的优势在于：完全可控，你可以精确决定包含哪些字符，最大化利用纹理空间；性能优异，TMP使用Signed Distance Field（SDF）技术，字体纹理可以任意缩放而不失真，且通过图集合并减少了Draw Call；效果丰富，完美支持TMP的所有高级渲染特性。唯一的“劣势”是需要一些前期配置工作，但一劳永逸。

注意：选择自定义字库方案，意味着你需要对项目用到的所有中文文本有一个预估。7000字的字库是一个比较均衡的选择，它覆盖了《通用规范汉字表》中的一级、二级字表，以及大部分常用汉字，能满足绝大多数游戏和应用的显示需求，同时纹理大小可控。

2.2 TextMeshPro的SDF技术核心

理解TMP为什么需要生成专属Asset，关键在于理解其使用的SDF（Signed Distance Field，有向距离场）渲染技术。传统位图字体会在放大时出现锯齿。SDF则不同，它不存储字符的像素图像，而是存储每个像素点到字符轮廓的“距离”信息。

在生成字体Asset时，工具会为每个选中的字符计算其轮廓的SDF数据，并将所有字符的SDF数据打包到一张纹理图集上。在运行时，Shader根据纹理上的SDF数据，实时计算出平滑的字符边缘，从而实现无论放大缩小都清晰锐利的显示效果，这就是所谓的“矢量”效果。因此，我们生成的自定义字库，本质上是一个包含了指定字符SDF信息的纹理图集和映射关系表。

3. 实战准备：工具、字体与字符集规划

在动手之前，我们需要准备好三样东西：字体源文件、字符列表和Unity工程。

3.1 字体文件的选择

不是所有.ttf字体都适合用于SDF生成。推荐选择轮廓清晰、笔画粗细均匀、无衬线的黑体类字体，例如：

• 思源黑体（Source Han Sans）：Google和Adobe联合开发，开源免费，字重齐全，覆盖字符极广，是首选。
• 方正系列（如方正兰亭黑）：商用需授权，但字形美观，在游戏UI中很常见。
• 站酷系列（如站酷酷黑）：部分可免费商用，需仔细阅读授权说明。

这里我选择思源黑体 Regular作为源字体。下载后，你会得到一个.ttf或.otf文件。

3.2 确定字符集：为什么是7000字？

盲目地把整个中文字库（数万字）都打包进去，会导致纹理图集巨大，内存占用高，生成时间漫长，且大部分字可能永远用不到。因此，我们需要一个“够用就好”的智能字符集。

1. 基础常用字：国家标准《通用规范汉字表》一级字表（3500字），这覆盖了99%以上的现代汉语书面语。
2. 扩充常用字：二级字表（3000字），加上一级字表共6500字，能覆盖绝大多数出版物和网络内容。
3. 项目特需字：根据你的项目内容额外添加。例如：
   • 历史题材：添加一些古代人名、地名用字。
   • 玄幻题材：添加一些生造字或异体字。
   • 系统通用：添加全角标点、数字、字母、常见符号等。

我采取的策略是：一级字表（3500）+ 二级字表（3000）+ 500个高频项目特需字 + 基本ASCII字符和标点，总数控制在7000-7200左右。你可以用一个文本文件（如characters.txt）来保存这个字符列表，每行一个字符或直接一串连续字符。

3.3 获取字符列表的实用技巧

手动收集7000个字不现实。这里有几个方法：

• 从规范文件提取：网上可以找到《通用规范汉字表》的文本版，直接复制。
• 用Python脚本分析项目文本：如果你已有游戏剧本或UI文本，可以写一个简单的Python脚本，读取所有文本文件，统计用到的唯一汉字，并排序输出。这是最精准的方法。

  # 示例：简单统计一个目录下所有.txt文件的唯一汉字 import os import codecs charset = set() for root, dirs, files in os.walk('Your/Text/Directory'): for file in files: if file.endswith('.txt'): with codecs.open(os.path.join(root, file), 'r', 'utf-8') as f: content = f.read() for char in content: if '\u4e00' <= char <= '\u9fff': # 基本判断是否为CJK汉字 charset.add(char) # 将集合排序并写入文件 with codecs.open('chinese_chars.txt', 'w', 'utf-8') as f: f.write(''.join(sorted(charset)))

• 利用现成字表：很多开源项目或字体工具会提供常用汉字字表，可以作为基础。

最终，我得到了一个约7100个字符的required_chars.txt文件。

4. 核心操作：使用Font Asset Creator生成字库

这是最关键的一步。在Unity编辑器中，通过Window > TextMeshPro > Font Asset Creator打开工具窗口。

4.1 工具界面参数详解与配置

工具界面看起来复杂，但我们需要关注的主要是以下几个部分：

1. Source Font File：点击Browse，选择你下载的思源黑体.ttf文件。
2. Sampling Point Size：采样点大小。这个值影响生成字体的基础质量和纹理大小。值越大，SDF数据越精细，抗锯齿效果越好，但纹理也会越大。对于用于UI的字体，72是一个很好的平衡点。如果你需要非常大的字号（如标题），可以考虑用到90或108。
3. Atlas Resolution：图集分辨率。这是最终生成的纹理图片的尺寸。因为我们要打包7000多个字，需要较大的图集。我尝试了2048x2048，发现有些字挤不进去。最终选择了4096x4096。这是移动设备上仍可接受的一个较大尺寸（注意OpenGL ES 2.0可能不支持4096，需根据目标平台调整）。如果字符更多，可能需使用8192x8192或启用Multiple Atlases（多图集）功能，但这会增加Draw Call。
4. Padding：内边距。字符与字符之间在纹理上的间隔，防止渲染时边缘互相干扰。对于SDF字体，建议设置为5-10。我设置为8。
5. Packing Method：打包算法。选择Optimum（最优）即可。
6. Character Set：字符集来源。这是核心！
   • 不要用ASCII或Unicode Range，那会包含巨量无用字符。
   • 选择Custom Character List（自定义字符列表）。
   • 在下面的Custom Character List大文本框里，粘贴你准备好的required_chars.txt文件中的全部字符（一串长长的汉字）。确保编码是UTF-8。
7. Render Mode：渲染模式。保持默认的SDFAA（SDF Anti-Aliasing）即可，它提供了最好的平滑效果。
8. Get Kerning Pairs：获取字距调整对。如果你的源字体文件包含字距信息（好的中文字体通常有），务必勾选。这能改善特定字符组合（如“中文”、“我们”）之间的视觉间距，让排版更专业。

4.2 生成过程与结果

配置完成后，点击右下角的Generate Font Atlas按钮。这个过程会比较耗时（几分钟），Unity会为列表中的每一个字符计算SDF并打包到一张4096x4096的纹理上。

生成成功后，你会看到预览窗口，可以输入文字测试效果。重点检查：

• 所有你需要的汉字是否都显示正常，没有变成“口”或空白。
• 放大后观察边缘是否平滑。
• 检查纹理图集的利用率（在预览窗口下方有显示）。我这次生成后利用率在85%左右，说明字符打包得比较紧凑，空间利用良好。

满意后，点击Save或Save as...，将生成的字体Asset保存到你的项目Assets目录下，例如Assets/Fonts & Materials/SourceHanSans_SDF.asset。同时，同目录下会生成一个同名的.png文件，这就是纹理图集。

实操心得：第一次生成时，我使用了1024x1024的图集，结果工具提示“Atlas is full”（图集已满）。这是新手常犯的错误。对于超过3000字的字库，请直接从2048x2048开始尝试。如果4096x4096仍然报满，可能是字符实在太多，或者Padding值设得太大，可以尝试减小Padding或启用多图集。

5. 在项目中使用自定义TMP字体

生成好的字体Asset就像其他Unity资源一样使用。

5.1 创建TMP文本对象并应用字体

1. 在UI Canvas下创建一个TextMeshPro - Text对象。
2. 选中该对象，在Inspector面板的TextMeshPro Text (Script)组件中，找到Font Asset字段。
3. 将你刚刚保存的SourceHanSans_SDF.asset拖拽赋值给它。
4. 在Text输入框中输入中文进行测试，例如“Unity 2023中文显示实战完美兼容！”。

你应该能看到所有字符都清晰显示。你可以随意调整字体大小（Font Size），得益于SDF技术，放大后边缘依然平滑。

5.2 设置默认字体（可选但推荐）

为了避免每次创建新的TMP文本都要手动指定字体，可以将其设为默认。

1. 打开Window > TextMeshPro > Settings。
2. 在Default Font Asset中，指定你的自定义SDF字体。
3. 这样，新建的TMP文本就会自动使用这个字体了。

5.3 使用富文本标签

TMP的强大之处在于富文本。现在你的中文字体已经可以完美支持这些标签了：

• 颜色：<color=#FF0000>红色文字</color>
• 大小：<size=24>大号字</size>
• 字体样式：<b>粗体</b>、<i>斜体</i>（注意：SDF字体本身可能不支持粗体/斜体，这些标签是通过Shader模拟的效果）
• 字距：<cspace=2.0>加宽间距</cspace>

在同一个文本框中混合使用中文和这些标签，检查显示是否正常。

6. 性能优化与内存管理

使用一个4096x4096的纹理图集，内存占用大约是4096 * 4096 * 4 bytes/pixel ≈ 67 MB（RGBA32格式）。这对于现代PC和主机平台可能不是问题，但对于内存紧张的移动端（尤其是低端机），就需要精打细算。

6.1 图集尺寸与格式优化

• 尺寸选择：在保证字符不溢出的前提下，尽量使用最小的2的幂次方尺寸。如果7000字用2048x2048能勉强放下（通过调整Padding和Packing Method），就优先用它。
• 纹理格式：在Unity中，选中生成的字体纹理图集（.png文件对应的Texture Asset），在Inspector中修改其导入设置。
  • 移动端（Android/iOS）：推荐使用ASTC压缩格式（如ASTC 6x6或8x8 block），它能大幅减少内存占用（从67MB降到十几MB甚至几MB），且视觉质量损失很小。这是目前移动平台的最佳实践。
  • PC/主机：可以使用BC7（DX11+）或DXT5等压缩格式，或者保持RGBA 32bit以获得最高质量。
  • 关键步骤：修改格式后，必须回到Font Asset Creator，重新打开你保存的.asset文件，在预览窗口点击Save覆盖保存一次，以更新字体Asset对纹理格式的引用。否则运行时可能找不到正确的纹理。

6.2 字符集动态分割

如果你的项目文本量巨大，且不同场景、不同系统用到的汉字差异很大（例如，新手村对话用字和古籍图书馆用字完全不同），可以考虑制作多个较小的、针对性的字体Asset。

• 方案一：按功能模块划分。例如，UI常用字库（2000字）、主线剧情字库（4000字）、典籍专用字库（1500生僻字）。在加载不同场景时，动态加载和卸载对应的字体Asset。
• 方案二：基础字库+扩展字库。一个包含最常用3500字的基础字库始终加载。当检测到生僻字缺失时，动态加载一个包含生僻字的扩展字库。TMP支持Fallback Font Asset List，可以设置备选字体。当主字体找不到字符时，会依次在备选列表中查找。你可以利用这个机制，但需要注意管理多个字库的内存。

6.3 字体Asset的加载与卸载

对于动态分割的字库，需要使用Resources.Load或Addressables/AssetBundle系统进行加载。当不再需要时（如切换场景），务必使用Resources.UnloadAsset或对应的释放接口来卸载字体Asset及其关联的纹理，防止内存泄漏。

7. 常见问题排查与解决方案实录

在实际集成和使用过程中，我遇到了以下典型问题，这里记录下排查思路和解决方法。

7.1 问题：部分汉字显示为“口”或空白

• 排查步骤1：检查字符是否在字库中。这是最常见的原因。在Font Asset Creator中重新打开你的字体Asset，在预览窗口下方的Character输入框里，粘贴那个显示不出来的汉字，看看预览是否正常。如果不正常，说明这个字确实不在你当初生成的字符列表里。
• 解决方案：将缺失的字符添加到你的required_chars.txt文件中，然后重新生成字体Asset。注意，重新生成会覆盖原有的图集，如果只是添加少量字符，可以新建一个补充字库作为Fallback。
• 排查步骤2：检查字体Asset引用。确保你的TMP文本组件上Font Asset字段引用的确实是你新生成的、包含该字符的Asset，而不是旧的或默认的。
• 排查步骤3：检查Fallback字体。如果你的TMP组件或全局设置里配置了Fallback字体，并且Fallback字体里也没有这个字，那么最终就会显示缺失。可以临时清空Fallback列表来确认。

7.2 问题：字体边缘模糊或有锯齿

• 原因1：采样点大小（Sampling Point Size）过低。如果生成时用的点大小（如48）远小于你在UI中实际使用的字体大小（如100），就会因为SDF数据精度不够而导致边缘模糊。
• 解决：对于需要大字号显示的字体，生成时使用更高的Sampling Point Size（如90）。
• 原因2：SDF Spread值问题。在字体Asset的Inspector中，有一个SDF Scale和Face Info中的Padding参数，会影响SDF的采样范围。通常不需要修改，但如果你做了非常极端的缩放，可以微调试试。
• 原因3：纹理压缩格式导致质量损失。如果为了移动端性能使用了高压缩比的ASTC格式（如12x12），可能会引入模糊。尝试使用质量更高的压缩块（如6x6或4x4），或在高端机上使用不压缩的格式。

7.3 问题：文本渲染出现重叠或裁剪

• 原因：字符几何信息（Glyph Metrics）异常。极少数情况下，从源字体提取的某个字符的边界框（Bounding Box）信息可能不正确，导致渲染时与其他字符重叠或被错误裁剪。
• 排查：在Font Asset Creator生成成功后，仔细浏览预览图，看是否有字符明显挤在一起或显示不完整。
• 解决：在字体Asset的Inspector中，找到Glyph Table，搜索有问题的字符，手动调整其xAdvance（水平步进宽度）或bearing（偏移）值。这是一个非常细致的调试工作，通常很少需要。

7.4 问题：在构建（Build）后中文不显示

• 排查步骤1：检查资源是否被打包。确保你的自定义字体Asset（.asset文件）和纹理图集（.png/.asset）位于Resources文件夹内，或者被包含在你使用的AssetBundle/Addressables分组中。Unity不会自动打包所有Assets目录下的东西。
• 排查步骤2：检查纹理图集导入设置。确保纹理图集的Texture Type是Default，并且Read/Write Enabled是勾选的（TMP运行时需要读取纹理数据）。虽然官方不推荐开启此选项（因为会增加内存），但对于TMP字体纹理，有时是必要的。如果遇到问题，可以尝试勾选。
• 排查步骤3：检查Shader变体。TMP使用的SDF Shader可能有多个变体。如果项目使用了Shader预编译（Shader Variant Collection），确保包含了TMP SDF Shader的必要变体。一个简单的测试方法是，在Player Settings的Graphics设置中，临时关闭Shader Variant Collection的预加载，看问题是否消失。

7.5 问题：在Input Field（TMP）中输入中文异常

• 现象：在TMP Input Field中，使用系统输入法输入中文时，候选框不跟随、输入组合异常等。
• 原因：这通常是Unity引擎对特定平台（尤其是某些Windows版本或Linux）的IME（输入法编辑器）支持问题，与字体本身关系不大。
• 尝试解决：
  1. 更新Unity到最新版本（2023 LTS），官方会持续修复IME相关问题。
  2. 检查Input Field组件的Soft Keyboard类型等设置。
  3. 对于桌面平台，可以考虑集成第三方原生输入法插件来获得更好的兼容性。

这个过程虽然有些繁琐，但一旦配置完成，项目就获得了一个坚实、可靠、高性能的中文显示基础。它不仅仅是解决了“显示”问题，更是为项目的文本渲染质量、UI性能和后续的本地化工作铺平了道路。自定义字库方案给了开发者最大的控制权，让你能根据项目的实际需求量身定制，在效果和性能之间找到最佳平衡点。