[BUG][🚨EMERGENCY] 编译报错 `\zihao {-4} undefined`, 影响 release

[jamesnulliu]

1. Bug Description

本地和在线 (overleaf) 编译都出现报错.

2. Steps to Reproduce

• Branch: hotfix/#48
• Commit: 32064c (latest)
• PR: 针对新版本（2025要求）的main.tex重构 #41 @IsaacGHX

1. 本地编译: bash scripts/build.sh 可在终端输出发现错误; 但是 pdf 正常生成.
2. 本地编译, 利用 wiki 中的方法, 直接报错, 无法生成 pdf.
3. overleaf 在线编译, 出现报错, 正常生成 pdf.

关键报错:

./contents/chap02.tex:9: Package caption Error: \zihao {-4} undefined.
./contents/cover.tex:24: Package caption Error: \zihao {-4} undefined.
# etc.

3. Expected Behavior

不应该输出报错.

4. Screenshots

5. Environment

Software	Version
OS / Docker Image	Windows 11
Tex	TexLive 2024

6. Additional Context

1. 对于维护者, 请切换到 hotfix/#48 分支, 对该分支进行 PR.
2. master 分支已经剥离可能造成问题的 commit, 包括:
   • @IsaacGHX 920ef4b
   • @LuminolT 32064c0e

[IsaacGHX]

建议如下解决：

二、解决方案（推荐顺序）
✅ 方案1：引入 ctex 宏包（推荐）
如果你的文档类是标准英文类（如 article、book），可以手动加载 ctex 宏包以启用 \zihao：

latex \usepackage[UTF8]{ctex}

加入位置：一般在 \documentclass 后，\begin{document} 前。

✅ 方案2：使用 ctex 的文档类
如果文档主要为中文内容，可以直接换用中文支持文档类：

latex \documentclass[UTF8]{ctexart} % 或 ctexbook, ctexrep 等

这样可以原生支持 \zihao，避免相关错误。

三、本地编译环境建议
如果本地使用的是 bash scripts/build.sh 编译，建议确认以下几点：

1.是否已安装 XeLaTeX 或 LuaLaTeX，并使用其进行编译（推荐 xelatex）；
2.是否安装 ctex 宏包，可以尝试：

latex tlmgr install ctex

或使用 TeX Live 完整安装（推荐完整安装以避免缺失宏包）；

若使用 make 或 build.sh 脚本，请确保它内部调用的是 xelatex 或 lualatex，而不是 pdflatex（不支持中文）。

四、如果你想避免使用 ctex，可以替换 \zihao 为标准字号命令：

\zihao{-4} | 等价于 小四号 \fontsize{12pt}{15pt}\selectfont

即替换为：
{\fontsize{12pt}{15pt}\selectfont 内容}
但不如直接引入 ctex 来得方便和稳妥。

————
烦请尝试，尽管我这里是能够生成就可以orz