如果你刚在Mac上装好TeXstudio兴冲冲写了第一份中文文档按下编译却收获满屏红色报错不用怀疑这是绝大多数Mac新用户都会遇到的坎。我这些年帮不少同学和同事排查LaTeX环境问题十有八九都卡在这一步。其实解决思路很短LaTeX传统的pdfLaTeX引擎按设计并不直接处理UTF-8编码的中文想在Mac上顺畅编译中文核心就两件事——把编译器换成XeLaTeX再让ctex宏包接管中文排版。整个过程不复杂大约就是装发行版、改一个编译器选项、套用模板三步本文就把完整流程和踩过的坑一起写清楚。1. 为什么默认配置在Mac上编译不了中文1.1 老引擎天生不认UTF-8LaTeX这个生态出身于纯英文时代底层的TeX引擎最初只设计来处理ASCII和少量西文扩展字符字体编码体系也是围绕西文建立的。pdfLaTeX作为经典引擎继承了这套老底子它默认把输入文件按TeX字体编码来解析遇到多字节的UTF-8中文会直接报“Unicode character not set up for use with LaTeX”之类错误或者干脆编译出乱码。很多人第一次遇到这类报错第一反应是去改字体、改编码其实根子在于引擎就不适合处理中文。打个比方pdfLaTeX像一台只能读英文打字机带的老式打印机你把中文文档塞进去它当然不知所措。XeTeX和LuaTeX这类现代引擎则完全不同它们直接基于Unicode工作能识别UTF-8编码的字符再通过字体接口调用系统里任意字体来处理中文形态所以中文编译的第一原则就是不要用pdfLaTeX改用XeLaTeX。1.2 XeLaTeX才是Mac上中文编译的正解在Mac上编译中文实际环境里最稳妥的选择就是XeLaTeX。它和LuaLaTeX都支持Unicode但XeLaTeX有二三十年的成熟积累主流中文宏包、期刊模板、学位论文模板基本都是围绕它测试的踩坑概率远低于LuaLaTeX。另外XeLaTeX调用系统字体的方式非常直接macOS自带的苹方、宋体、黑体都能直接按名字取用这就让中文排版效果非常接近原生文档。既然引擎选定了接下来的一切配置都围绕它展开。TeXstudio里只需要把默认编译器从pdfLaTeX改成XeLaTeX这个问题就解决了一大半。1.3 ctex宏包到底在干什么引擎负责“认识”中文排版细节则由宏包处理。ctex宏包和ctexart文档类就是为此而生的它统一处理中文字体设置、段落缩进、标题中文化、日期中文化等一堆版式问题。比如你用ctexart文档类\section生成的章节标题默认就是中文“第1章 绪论”这类样式\maketitle里的作者、日期也会呈现中文形态省去手工配置的麻烦。ctex在Mac上还有一个便利之处它内置了针对macOS的字体方案能自动匹配系统中文字体族。但如果你的ctex版本较老或系统字体缺失自动匹配可能失效这时需要手动指定fontset后面我会详细说。2. 环境准备装对发行版和编辑器2.1 MacTeX与BasicTeX怎么选LaTeX在Mac上最常见的发行版是MacTeX和BasicTeX。MacTeX是完整发行版体积大、安装时间长但好处是开箱即用xelatex、ctex、xeCJK、fontspec这些常用宏包全部预装装完就能直接编译中文。BasicTeX体积小很多只包含基础宏包装完后要用tlmgr install ctex xecjk fontspec等命令自行补齐中文学需要的宏包对新手来说容易卡在宏包缺失这一步。我的经验是如果你只想尽快把中文文档跑起来直接安装MacTeX不要犹豫。等以后熟悉了、磁盘紧张了再考虑精简方案不迟。安装方式一般下载pkg安装包也可以借助包管理器安装完成后TeX Live目录位于/usr/local/texlive/202x对应安装年份其中的命令通过/Library/TeX/texbin链接到系统PATH里。2.2 TeXstudio安装两种方式TeXstudio的安装同样有两条路。一是从官网下载dmg镜像拖进应用程序文件夹二是用Homebrew执行brew install --cask texstudio。使用dmg方式的话macOS Gatekeeper可能会拦截首次打开需要在Dock或访达里对TeXstudio图标右键选择“打开”或者在“系统设置-隐私与安全性”里手动允许。用Homebrew方式则通常没有这个权限问题依赖也会自动处理。安装完成后建议先做一次环境体检打开终端输入which xelatex如果能返回类似/Library/TeX/texbin/xelatex的路径说明XeLaTeX已经进入PATH如果提示找不到命令多半是PATH没生效或安装不完整需要重新安装或手动指定完整路径。2.3 装好后先确认两件事第一在TeXstudio里打开“TeXstudio菜单-Preferences”左侧找到“命令”Commands确认xelatex对应的路径正确。大多数情况下它会自动探测到但如果弹出“could not start command”之类的错误手动把xelatex改成完整路径/Library/TeX/texbin/xelatex即可。第二确认编辑器默认编码是UTF-8。TeXstudio的新版本基本默认UTF-8但如果你的文件是从其他编辑器拷贝过来的旧文档保存时务必另存为UTF-8编码否则中文可能变成乱码或编译报错。3. 核心操作把TeXstudio切到XeLaTeX3.1 找到编译配置入口这一节是全篇最关键的操作。在TeXstudio界面里点击顶部菜单“TeXstudio - Preferences”打开偏好设置在左侧找到“构建”Build页面。页面上方第一个下拉菜单就是“默认编译器”默认值通常是“PdfLaTeX”把它改成“XeLaTeX”然后点确定。有些版本在工具栏“构建并查看”按钮的右侧还有一个下拉箭头里面可以直接切换编译器效果一样。如果你已经打开了一个旧文档也可以通过这个下拉箭头临时把当前文档切到XeLaTeX无需修改全局设置。大多数情况下直接改默认编译器一劳永逸之后所有文档都用XeLaTeX编译。3.2 连带设置的几个细节切换编译器之后顺手检查两个关联设置。第一“构建”页面中的默认文献工具如果你之后要写带参考文献的中文文档建议把默认文献工具从“BibTeX”改成“Biber”配合biblatex宏包使用中文参考文献的处理更顺畅。第二编辑器页面里的显示字体。TeXstudio默认使用的编辑字体可能不包含中文字形这会导致编辑区中文显示为方块但编译出来的PDF却一切正常。遇到这种情况在“编辑器-显示-字体”里把字体改成“PingFang SC”或“Songti SC”等Mac自带中文字体即可。这一步不影响编译结果只影响编辑体验但很多人会被“编辑器方块但PDF正常”的现象误导以为文档有问题。3.3 快捷键与日常构建流程TeXstudio默认的快捷键是F5一键“构建并查看”即编译并打开PDF预览F6只编译F7查看PDF。切换完XeLaTeX后直接按F5就能看到编译结果。首次编译时XeLaTeX会比pdfLaTeX慢一些因为要生成字体缓存这是正常现象之后就会快很多。如果PDF预览没有自动打开按F7手动打开即可。TeXstudio内置的PDF查看器支持反向同步按住Command同时点击PDF中的文字会跳转到对应的LaTeX源码行这对后续修改文档非常方便。4. 最小中文文档从无到有跑通第一次编译4.1 先保存文件再写代码在TeXstudio里新建文件后建议先保存一次明确文件后缀为.tex并确认编码是UTF-8。中文文档强烈建议文件名不要包含中文或特殊符号用main.tex或demo.tex这类简单命名避免某些场景下路径解析出错。接着输入下面这段最简代码这是我在Mac上测试中文环境时反复使用的模板干净利落不含任何多余宏包。\documentclass[UTF8]{ctexart} \begin{document} 你好世界。 这是第一份用 XeLaTeX 编译的中文文档。 \[ E mc^2 \] \end{document}这里有两个关键点一是文档类用了ctexart它等价于article加上ctex宏包会自动处理中文标题、目录、缩进等版式二是文档类选项里的UTF8明确告诉ctex输入编码是UTF-8。保存后按F5如果控制台没有红色报错PDF窗口出现了“你好世界”和公式那你的中文环境就正式跑通了。4.2 更稳的中文字体回退方案上面模板使用的是ctex默认字体方案。在较新的ctex版本中\documentclass[fontsetmac, UTF8]{ctexart}可以强制使用macOS系统中文字体组合编译效果更好。但如果你用的ctex版本较老可能不认识mac这个选项此时可以回退到fontsetfandol。\documentclass[fontsetfandol, UTF8]{ctexart}fandol是ctex宏包自带的一套开源中文字体不依赖系统字体在任何平台都能编译通过。它的字体风格偏印刷体虽然没有苹方、宋体那么精致但作为兜底方案非常可靠。我个人的习惯是正式文档用fontsetmac临时测试或应急场景用fontsetfandol。4.3 首次编译要看什么第一次编译时控制台会滚动大量日志新手容易看得一头雾水。其实只需要关注两处最后一行如果出现Output written on main.pdf且在括号里显示页数说明编译成功如果出现errors后方括号里的数字大于0说明有错误。XeLaTeX的报错信息通常会定位到具体行号和宏包名称顺着报错排查即可。有一个经验值得说首次编译慢是正常的尤其是字体缓存构建阶段日志里可能出现类似“mktexfmt”“font cache”等字样耐心等它跑完。如果遇到编译卡住超过两三分钟多半是宏包缺失或版本冲突直接看报错信息处理最快。5. Mac中文字体与版式进阶5.1 Mac自带中文字体速查XeLaTeX最大的优势就是能直接调用系统字体。在Mac上我们常用的中文字体主要是这几种字体中文名字体英文名fontspec用这个适用场景苹方-简PingFang SC现代无衬线适合屏幕阅读和演示宋体-简Songti SC正文宋体正式文档首选黑体-简Heiti SC标题、强调楷体-简Kaiti SC引文、注释华文仿宋STFangsong公文风格的文本华文宋体STSong老牌宋体变体想查看系统里有哪些中文字体可以打开macOS自带的“字体册”应用或者在终端里执行fc-list :langzh前提是PATH里有fontconfig工具。字体名严格区分大小写和空格配置时务必准确比如“Songti SC”中间的空格不能省略。5.2 用xeCJK手动指定中文字体ctex宏包已经提供了完整的字体方案但有时你想自定义字体组合比如正文用宋体、标题用黑体、代码用仿宋。这时可以直接用xeCJK层的命令手动指定\documentclass[UTF8]{ctexart} \usepackage{fontspec} \setCJKmainfont{Songti SC} % 正文 \setCJKsansfont{Heiti SC} % 无衬线标题 \setCJKmonofont{STFangsong} % 等宽/代码注意\setCJKmainfont等命令来自xeCJKctex宏包会自动加载它所以无需单独\usepackage{xeCJK}。但如果你想绕开ctex、只用xeCJK那就要自己处理段落缩进和标题中文化等细节相对繁琐。我的建议是日常写作以ctex为主需要精细控制字体时才补上这几个命令。5.3 中英文混排怎么做才自然中文文档几乎必然遇到中英文混排。ctex默认用\setCJKmainfont指定的字体处理汉字用\setmainfont指定的字体处理西文和数字。比如我希望正文汉字用宋体、西文用Times New Roman可以这样写\documentclass[fontsetmac, UTF8]{ctexart} \usepackage{fontspec} \setmainfont{Times New Roman} \setCJKmainfont{Songti SC}这样设置后中英文之间会自动适配间距中文标点也由ctex统一处理段落首行缩进两字符是默认行为整体版式看起来很舒服。写正文时不需要手工加空格来分隔中英文直接连续输入即可。5.4 一套可复用的中文模板我自己在Mac上一直用下面这套模板兼顾了正式文档所需的标题、目录、表格和代码块支持。你直接复制保存成snippet新建文档时套用即可\documentclass[fontsetmac, UTF8]{ctexart} \usepackage{fontspec} \setmainfont{Times New Roman} \setCJKmainfont{Songti SC} \usepackage{amsmath, amssymb} \usepackage{booktabs} \usepackage{graphicx} \title{测试中文文档} \author{某开发者} \date{\today} \begin{document} \maketitle \tableofcontents \section{引言} 这里是正文内容。 \end{document}这套模板能覆盖大多数中文文章、报告、作业的场景编译一次通过后后续写作只需要替换正文内容不用再折腾环境。6. 常见问题与排查技巧实录6.1 高频报错速查表下面这些是我实际处理过的高频问题整理成速查表遇到直接对照报错或现象可能原因处理方法File ctex.sty not found宏包未安装常见于BasicTeX执行sudo tlmgr install ctex xecjk fontspecUnicode character ... not set up仍在用pdfLaTeX编译在偏好设置里把默认编译器改成XeLaTeXThe font XXX cannot be found字体名写错或fontset对应字体缺失用字体册查看准确字体名或改用fontsetfandol编译成功但PDF里中文是方块PDF查看器或字体嵌入问题换用现代字体PingFang SC/Songti SC确认用XeLaTeX编辑器中文显示方块PDF正常编辑器字体不含中文字形编辑器设置里把显示字体改成PingFang SC提示无法启动xelatex命令GUI应用没继承PATH命令设置里填完整路径/Library/TeX/texbin/xelatexfontset mac is unavailablectex版本较老改用fontsetfandol或升级TeX Live6.2 关于输入法在TeXstudio里打不出中文在个别旧版本的TeXstudio里Mac用户会遇到一个非常恼火的问题用系统输入法打中文时候选词无法上屏或者打完中文后候选框消失但编辑器里没字。这不是文档配置的问题而是编辑器本身对macOS输入法兼容性不佳。最直接的解法是把TeXstudio升级到最新版新版本基本已经修复。如果暂时无法升级临时方案是先在“文本编辑”或其他地方打好中文粘贴进TeXstudio等编辑完再统一调整格式。6.3 参考文献中文乱码从哪查起如果正文正常但参考文献里的中文乱码先检查两个点第一文献工具是否已经切成Biber如果没有在“构建-默认文献工具”里切换第二是否在导言区正确引入了biblatex并设置UTF-8选项。编译链要按XeLaTeX → Biber → XeLaTeX → XeLaTeX的顺序跑TeXstudio的“构建并查看”会自动执行这套流程但前提是默认编译器与文献工具都设置正确。6.4 我的排查顺序和个人体会最后分享一个我自己的排查习惯遇到中文编译问题永远先问三件事——编译器是不是XeLaTeX文件编码是不是UTF-8宏包是不是齐全这三件事解决了九成问题都会消失。只有当这三项都没问题时我才会去怀疑字体名、路径、输入法等外围因素。这个习惯帮我节省了大量排查时间也推荐你试试。另外在Mac上配置好中文环境后把最小可用模板固定下来存成TeXstudio的snippet或一个单独的模板文件以后所有文档都从它开始。后续就算换电脑、重装系统只要按这套流程走一遍十分钟就能恢复环境不需要再踩一遍最初的坑。