很多刚开始学习 ManimCE 的同学，在兴致勃勃地想要制作中文数学动画时，都会遇到同一个“拦路虎”：一旦在公式里输入中文，程序直接报错，红一片！
比如你想写“勾股定理”，直接这样写：
# 错误示范 ❌
tex = MathTex("勾股定理：a^2+b^2=c^2")
运行后，你会得到一堆 LaTeX 编译错误。这是因为默认的 LaTeX 模板是不支持中文字符的。
别担心，今天我们就来彻底解决这个问题，教会大家如何在 MathTex、Tex 以及 Title 组件中优雅地显示中文。
1. 为什么会出现报错？
Manim 底层使用 LaTeX 来渲染公式。
标准的 LaTeX 环境主要针对英文和数学符号设计，如果没有加载特定的中文宏包（如 ctex），它就无法识别汉字，从而导致编译失败。
所以，核心思路就是：告诉 Manim 使用支持中文的 LaTeX 模板。
2. 三大组件的中文显示方案
在 ManimCE 中，常用的可以显示数学公式的三个组件是 MathTex、Tex 和 Title。
它们显示中文的设置略有不同，我们逐个来看。
2.1. MathTex 组件
MathTex 主要用于数学公式。要显示中文，只需要添加一个关键参数：tex_template。
- 解决方法：设置
tex_template=TexTemplateLibrary.ctex - 代码示例：
# 正确示范 ✅
tex02 = MathTex(r"\text{勾股定理}: a^2+b^2=c^2",tex_template=TexTemplateLibrary.ctex, # 关键！
)
注意：中文最好包裹在 \text{} 中，这样 LaTeX 才知道这是文本而不是数学变量。
2.2. Tex 组件
Tex 组件通常用于包含更多文本内容的段落。对于中文显示，它比 MathTex 多了一个要求。
- 解决方法：需要同时设置
tex_template和tex_environment。 - 关键参数：
tex_template=TexTemplateLibrary.ctextex_environment="align*"
- 代码示例：
# 正确示范 ✅
tex01 = Tex(r"\text{勾股定理}: a^2+b^2=c^2",tex_environment="align*", # 关键！tex_template=TexTemplateLibrary.ctex, # 关键！
)
2.3. Title 组件
Title 组件用于生成标题。很多同学不知道，其实 Title 底层是继承自 Tex 组件的。
- 解决方法：既然它继承自
Tex，那么它显示中文的要求也与Tex完全一致。 - 关键参数：同样需要
tex_environment="align*"和tex_template=TexTemplateLibrary.ctex。 - 代码示例：
# 正确示范 ✅
title = Title(r"\text{勾股定理}: a^2+b^2=c^2",tex_environment="align*", # 关键！tex_template=TexTemplateLibrary.ctex, # 关键！
)
3. 完整代码演示
为了让大家能够直接运行成功，我整理了一份完整的代码示例。你可以直接复制到你的编辑器中尝试。
from manim import *class Keshihua(Scene):def construct(self):# 1. Tex 组件显示中文# 需要两个参数：tex_environment 和 tex_templatetex01 = Tex(r"\text{勾股定理}: a^2+b^2=c^2",tex_environment="align*",tex_template=TexTemplateLibrary.ctex,).set_color_by_gradient(RED, GREEN)self.play(Write(tex01))# 2. MathTex 组件显示中文# 只需要一个参数：tex_templatetex02 = MathTex(r"\text{勾股定理}: a^2+b^2=c^2",tex_template=TexTemplateLibrary.ctex,).set_color_by_gradient(YELLOW, BLUE)tex02.next_to(tex01, DOWN)self.play(Write(tex02))# 3. Title 组件显示中文# 因为继承自 Tex，所以参数要求与 Tex 相同title = Title(r"\text{勾股定理}: a^2+b^2=c^2",tex_environment="align*",tex_template=TexTemplateLibrary.ctex,)self.play(Write(title))self.wait()
4. 总结与建议
为了方便记忆，我把今天的重点整理成了一个小表格：
| 组件类型 | 是否需要中文模板？ | 是否需要指定环境？ | 关键参数设置 |
|---|---|---|---|
| MathTex | ✅ 是 | ❌ 否 | tex_template=TexTemplateLibrary.ctex |
| Tex | ✅ 是 | ✅ 是 | tex_template=..., tex_environment="align*" |
| Title | ✅ 是 | ✅ 是 | 同 Tex 组件 |
小贴士：
- 环境配置：确保你的电脑已经安装了
LaTeX环境（如TeX Live或MiKTeX），并且安装了ctex宏包。Manim调用的是系统本地的LaTeX编译器。 - 转义字符：在
Python字符串中，记得在公式前加r（如r"\text{...}"），防止反斜杠被转义。 - 文本包裹：尽量用
\text{}包裹中文，这样排版会更规范。
希望这篇教程能帮你扫清障碍，做出更漂亮的中文数学动画！