本文首发于 CSDN转载请注明出处。先说结论LaTeX 装完之后中文显示不出来或者编译中断九成是编译引擎选错了。中文文档必须用 XeLaTeX 引擎并且加载 ctex 宏包用默认的 pdfLaTeX 编译中文轻则乱码重则直接报错退出。第二个要先纠正的观念那些「CTeX 套装」的教程已经过时了那套 Windows 打包在十多年前就停止更新现在正确做法是装 TeX Live 发行版中文支持靠 ctex 宏包解决不需要额外装套装。该装哪个发行版LaTeX 本身只是一套排版语言你要装的是它的发行版。主流就两个选一个即可发行版平台特点适合谁TeX LiveWindows / Linux / macOS跨平台、包最全、官方推荐大多数人的首选MacTeXmacOS基于 TeX Live 的 macOS 封装Mac 用户图省事MiKTeXWindows按需下载宏包初始体积小磁盘紧张、网络稳定不要在同一个系统上同时装 TeX Live 和 MiKTeX。两者的命令会互相覆盖PATH里谁在前面谁生效出问题时非常难定位。已经装过其中一个又换了另外一个先把旧的彻底卸载。Windows 用户如果选 MiKTeX好处是首次安装体积小、用到哪个宏包再下哪个代价是每次编译新文档可能需要联网。TeX Live 一次装全之后离线也能编译体积以 GB 计。下载渠道认两个官方站点以及国内的 CTAN 镜像。中文文档里镜像站的速度优势很明显装一次可以省不少时间。macOS 用户可以直接用包管理器装 MacTeX省掉手动运行安装脚本的步骤# macOS 用包管理器安装 MacTeXbrewinstall--caskmactex# Linux / macOS 手动安装 TeX Live 的主流程# 下载 iso 后挂载运行安装脚本./install-tlWindows 上解压安装包后运行那个带 windows 后缀的批处理文件图形界面下一步步走完即可。安装完成后要确认可执行文件目录已经写进PATH通常长这样# 安装目录下的 bin 平台子目录要加进 PATH/usr/local/texlive/2026/bin/x86_64-linux# 验证是否可用tex--versiontlmgr--versiontlmgr是 TeX Live 的包管理器后面装宏包、更新宏包都靠它能跑起来说明安装是成功的。中文文档该怎么写这是新手最容易卡住的地方记住三件事。第一引擎选 XeLaTeX。pdfLaTeX 面向的是西文排版对中文字体的处理方式完全不同直接编译中文会报字体找不到。XeLaTeX 直接调用系统字体中文天然支持。第二加载 ctex 宏包。它把中文的断行规则、标点挤压、章节标题格式都配好了不用自己一项项设。第三最小可用模板长这样可以先拿它验证环境% 用 XeLaTeX 编译这个文件 \documentclass[UTF8]{ctexart} \title{中文排版最小示例} \author{作者} \date{\today} \begin{document} \maketitle \section{第一节} 这是正文。中英文混排 XeLaTeX 也能处理。 \end{document}ctexart是带中文支持的文章文档类ctex官方的这一系列文档类开箱就能用比在标准文档类上手动加载 ctex 宏包更省心。编译时要主动指定引擎。用命令行是这样# 指定 XeLaTeX 引擎编译xelatex main.tex如果你的编辑器里有「快速编译」按钮它是按文档里写的引擎走的默认往往是 pdfLaTeX。所以装完先去编辑器设置里把默认编译链改成 XeLaTeX否则每次都要手动切。装宏包、换源怎么做宏包缺失时的报错长这样文件名后面跟着.sty后缀找不到。TeX Live 环境下用命令行装# 安装缺失的宏包tlmgrinstall宏包名# 一次装多个tlmgrinstallctex booktabs caption默认源在海外国内直连经常超时。换成国内镜像之后速度和成功率都会好很多这条命令只需要执行一次# 把宏包源换成国内镜像以清华镜像为例tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet换完再执行tlmgr update --self更新一下管理器自身。如果用的是 MiKTeX它有图形化的宏包管理器也可以在设置里打开「安装缺失宏包时自动下载」这样编译时遇到缺包会自己补上不用手动查名字。报错信息怎么读LaTeX 的报错信息出了名的不友好但常见的就那么几类报错关键词原因处理找不到字体提示无法加载用了 pdfLaTeX 编译中文换成 XeLaTeX 引擎重新编译文件名后面跟.sty找不到缺宏包用包管理器补装或换国内源未定义控制序列命令拼错或忘了加载对应宏包核对拼写与宏包名中文显示成方块或问号字体没有正确加载确认用 XeLaTeX 编译且已加载 ctex编译卡住不动某处语法让排版陷入循环从报错位置往前逐段注释排查排查顺序建议固定下来先确认引擎对不对再确认宏包齐不齐最后才看具体语法。前两项是环境问题一次解决永久受益第三项是单篇文档的问题逐处定位即可。还有个容易被忽略的细节编译失败会留下辅助文件这些文件里存着上一次的状态偶尔会让错误反复出现。清理掉再编译一次症状常常就消失了。环境配置、中文模板和报错对照我整理成了一份存档换机器时直接把模板抄过去比重新查一遍中文支持怎么配快得多。写这类需要反复核对发行版和引擎配置的教程时我会用墨衍的AI 图文同步把稿子一次推到几个平台留档集中更新的那几天靠发文额度提升不用排队发完再用批量 GEO 检测看看这些内容在 AI 搜索里的引用情况。墨衍会员权益 有需要可以了解。常见问题QLaTeX 要装 Java 吗不需要。这是早期文档留下的误解TeX Live 本身不依赖 Java。安装包体积大是因为宏包数量多。Q可以用 VS Code 写 LaTeX 吗可以装一个 LaTeX 的扩展就能编译、跳转、预览。它本质上还是调用你本机装好的发行版所以发行版要先装好。QOverleaf 这类在线编辑器能不能替代本地安装能覆盖大部分场景协作方便、不用配环境。缺点是编译时间有限额、大文档编译慢工程里含大量自定义字体或本地图片时不方便。Q中文论文一定要用 XeLaTeX 吗目前中文排版最省事的方案是它。也用 LuaLaTeX 的方案但中文宏包生态对 XeLaTeX 支持更成熟。Q装了宏包但编译还是说找不到先确认装到了当前生效的那个发行版里。系统上存在两套发行版时命令行装的宏包和编辑器调用的是两套环境这是很容易出现的一种错位。Q能不能只装需要的宏包不装完整发行版可以MiKTeX 就是这么设计的。代价是要联网按需下载离线环境下会卡住。关于墨衍如果你也在多个平台发技术文章值得看看墨衍。三个最常用的权益——发文额度提升密集更新不再受限、批量 GEO 检测一次扫完全部文章的 AI 引用状态、AI 图文同步一稿多平台分发。点这里了解墨衍会员 LaTeX 安装教程：中文乱码、编译报错，多半是引擎选错了
本文首发于 CSDN转载请注明出处。先说结论LaTeX 装完之后中文显示不出来或者编译中断九成是编译引擎选错了。中文文档必须用 XeLaTeX 引擎并且加载 ctex 宏包用默认的 pdfLaTeX 编译中文轻则乱码重则直接报错退出。第二个要先纠正的观念那些「CTeX 套装」的教程已经过时了那套 Windows 打包在十多年前就停止更新现在正确做法是装 TeX Live 发行版中文支持靠 ctex 宏包解决不需要额外装套装。该装哪个发行版LaTeX 本身只是一套排版语言你要装的是它的发行版。主流就两个选一个即可发行版平台特点适合谁TeX LiveWindows / Linux / macOS跨平台、包最全、官方推荐大多数人的首选MacTeXmacOS基于 TeX Live 的 macOS 封装Mac 用户图省事MiKTeXWindows按需下载宏包初始体积小磁盘紧张、网络稳定不要在同一个系统上同时装 TeX Live 和 MiKTeX。两者的命令会互相覆盖PATH里谁在前面谁生效出问题时非常难定位。已经装过其中一个又换了另外一个先把旧的彻底卸载。Windows 用户如果选 MiKTeX好处是首次安装体积小、用到哪个宏包再下哪个代价是每次编译新文档可能需要联网。TeX Live 一次装全之后离线也能编译体积以 GB 计。下载渠道认两个官方站点以及国内的 CTAN 镜像。中文文档里镜像站的速度优势很明显装一次可以省不少时间。macOS 用户可以直接用包管理器装 MacTeX省掉手动运行安装脚本的步骤# macOS 用包管理器安装 MacTeXbrewinstall--caskmactex# Linux / macOS 手动安装 TeX Live 的主流程# 下载 iso 后挂载运行安装脚本./install-tlWindows 上解压安装包后运行那个带 windows 后缀的批处理文件图形界面下一步步走完即可。安装完成后要确认可执行文件目录已经写进PATH通常长这样# 安装目录下的 bin 平台子目录要加进 PATH/usr/local/texlive/2026/bin/x86_64-linux# 验证是否可用tex--versiontlmgr--versiontlmgr是 TeX Live 的包管理器后面装宏包、更新宏包都靠它能跑起来说明安装是成功的。中文文档该怎么写这是新手最容易卡住的地方记住三件事。第一引擎选 XeLaTeX。pdfLaTeX 面向的是西文排版对中文字体的处理方式完全不同直接编译中文会报字体找不到。XeLaTeX 直接调用系统字体中文天然支持。第二加载 ctex 宏包。它把中文的断行规则、标点挤压、章节标题格式都配好了不用自己一项项设。第三最小可用模板长这样可以先拿它验证环境% 用 XeLaTeX 编译这个文件 \documentclass[UTF8]{ctexart} \title{中文排版最小示例} \author{作者} \date{\today} \begin{document} \maketitle \section{第一节} 这是正文。中英文混排 XeLaTeX 也能处理。 \end{document}ctexart是带中文支持的文章文档类ctex官方的这一系列文档类开箱就能用比在标准文档类上手动加载 ctex 宏包更省心。编译时要主动指定引擎。用命令行是这样# 指定 XeLaTeX 引擎编译xelatex main.tex如果你的编辑器里有「快速编译」按钮它是按文档里写的引擎走的默认往往是 pdfLaTeX。所以装完先去编辑器设置里把默认编译链改成 XeLaTeX否则每次都要手动切。装宏包、换源怎么做宏包缺失时的报错长这样文件名后面跟着.sty后缀找不到。TeX Live 环境下用命令行装# 安装缺失的宏包tlmgrinstall宏包名# 一次装多个tlmgrinstallctex booktabs caption默认源在海外国内直连经常超时。换成国内镜像之后速度和成功率都会好很多这条命令只需要执行一次# 把宏包源换成国内镜像以清华镜像为例tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet换完再执行tlmgr update --self更新一下管理器自身。如果用的是 MiKTeX它有图形化的宏包管理器也可以在设置里打开「安装缺失宏包时自动下载」这样编译时遇到缺包会自己补上不用手动查名字。报错信息怎么读LaTeX 的报错信息出了名的不友好但常见的就那么几类报错关键词原因处理找不到字体提示无法加载用了 pdfLaTeX 编译中文换成 XeLaTeX 引擎重新编译文件名后面跟.sty找不到缺宏包用包管理器补装或换国内源未定义控制序列命令拼错或忘了加载对应宏包核对拼写与宏包名中文显示成方块或问号字体没有正确加载确认用 XeLaTeX 编译且已加载 ctex编译卡住不动某处语法让排版陷入循环从报错位置往前逐段注释排查排查顺序建议固定下来先确认引擎对不对再确认宏包齐不齐最后才看具体语法。前两项是环境问题一次解决永久受益第三项是单篇文档的问题逐处定位即可。还有个容易被忽略的细节编译失败会留下辅助文件这些文件里存着上一次的状态偶尔会让错误反复出现。清理掉再编译一次症状常常就消失了。环境配置、中文模板和报错对照我整理成了一份存档换机器时直接把模板抄过去比重新查一遍中文支持怎么配快得多。写这类需要反复核对发行版和引擎配置的教程时我会用墨衍的AI 图文同步把稿子一次推到几个平台留档集中更新的那几天靠发文额度提升不用排队发完再用批量 GEO 检测看看这些内容在 AI 搜索里的引用情况。墨衍会员权益 有需要可以了解。常见问题QLaTeX 要装 Java 吗不需要。这是早期文档留下的误解TeX Live 本身不依赖 Java。安装包体积大是因为宏包数量多。Q可以用 VS Code 写 LaTeX 吗可以装一个 LaTeX 的扩展就能编译、跳转、预览。它本质上还是调用你本机装好的发行版所以发行版要先装好。QOverleaf 这类在线编辑器能不能替代本地安装能覆盖大部分场景协作方便、不用配环境。缺点是编译时间有限额、大文档编译慢工程里含大量自定义字体或本地图片时不方便。Q中文论文一定要用 XeLaTeX 吗目前中文排版最省事的方案是它。也用 LuaLaTeX 的方案但中文宏包生态对 XeLaTeX 支持更成熟。Q装了宏包但编译还是说找不到先确认装到了当前生效的那个发行版里。系统上存在两套发行版时命令行装的宏包和编辑器调用的是两套环境这是很容易出现的一种错位。Q能不能只装需要的宏包不装完整发行版可以MiKTeX 就是这么设计的。代价是要联网按需下载离线环境下会卡住。关于墨衍如果你也在多个平台发技术文章值得看看墨衍。三个最常用的权益——发文额度提升密集更新不再受限、批量 GEO 检测一次扫完全部文章的 AI 引用状态、AI 图文同步一稿多平台分发。点这里了解墨衍会员