如果你打开这篇博文,大概率正面临两件事:刚接触 LaTeX,被论文模板按在地上摩擦;或者 C 盘告急,根本塞不下一个动辄五六个 GB 的 TeX Live。我帮同学和同事装过几十次 TeX Live + TeXstudio,说实话,这套组合的坑大多数不在安装本身,而在安装前的准备和安装后的配置。这篇文章就以 TeX Live 2020 + TeXstudio 为例,给你一份能把环境完整装到非系统盘的教程,覆盖镜像下载、安装参数、路径修改、编辑器对接、中文支持和常见报错排查。目标读者很明确:Windows 用户、正在写学位论文的科研党、以及所有不想把 C 盘塞爆的人。照着走完,你能从任意一个英文路径的文件夹里编译出合格的 PDF。
1. 为什么非要把 TeX Live 装到非系统盘?装之前先想清楚
1.1 装非系统盘的三条真实理由
先说体积。TeX Live 2020 以 scheme-full 完整安装后,宏包和字体全部落地大约要占 7 到 8 GB,这还不包括你以后用 tlmgr 更新宏包时产生的缓存文件。很多笔记本的 C 盘只有 128GB 或 256GB,Windows 系统、软件、桌面文件堆一堆,再硬塞一个 TeX Live,C 盘很快见红。把发行版装到 D 盘或 E 盘,这件事可以一次做对,以后不用返工。
第二条理由是重装系统的场景。装在非系统盘,哪天系统崩溃要重置 Windows,D 盘上的 TeX Live 主体和本地宏包都还在。虽然环境变量和注册表信息需要重新配,但至少不用再经历一次四十分钟的漫长安装过程。对于赶论文的人来说,重装系统后能在一小时内恢复工作环境,实在太重要了。
第三条理由是权限和运行稳定性。Windows 对系统盘下的 Program Files 等目录有额外的权限控制和 UAC 拦截,杀毒软件也喜欢盯 Program Files 上运行的程序。TeX Live 安装到 D 盘后,写文件、调字体、跑 perl 脚本都会自由很多,不容易出现莫名其妙的“权限不足”和文件被锁的糟心事。
| 对比项 | 装 C 盘 | 装 D 盘 / 其他分区 |
|---|---|---|
| 空间占用 | 挤占系统盘,后期容易告急 | 释放系统盘,互不干扰 |
| 重装系统 | 数据全没,需从头再装 | 主体保留,重配环境变量即可 |
| 权限问题 | 容易被 UAC 和杀软拦截 | 权限问题明显减少 |
| 日常维护 | 受系统盘读写影响较大 | 独立分区,更灵活 |
1.2 版本选型:2020 还值得装吗
TeX Live 是 TUG 发布的年度发行版,每年出一个新版本。2020 年对应的 ISO 文件叫 texlive2020-20200406.iso,是 2020 年 4 月定稿的。现在官网最新版本已经往前推了好几年,但 2020 依然值得装,主要因为大量学位论文模板和期刊模板是在 2020 版本上验证过的,用它编译这些模板最容易一次通过。
比起装最新版,更值得关注的是版本之间的迁移成本。TeX Live 从 2018 年到现在的安装流程几乎是同一套逻辑,这篇文章里的方法换到其他年份版本一样适用。你只要把 2020 换成 2024 或 2025,路径里的年份改一下,其余操作完全相同。所以不用担心学了这个教程就过时,真正要掌握的是这套安装和配置的思路。
做版本对比时,很多人会在 TeX Live 和 MiKTeX 之间纠结。MiKTeX 的优势是按需安装宏包,硬盘占用小,但它有个明显痛点:第一次编译某个文档时经常要现场下载缺失宏包,网络不好就卡在半路。CTeX 套装则已经很多年没有实质更新,在 Windows 10 和 Windows 11 上跑起来不太省心。TeX Live 走的是全量本地安装路线,宏包齐全,离线也能编译,这也是我始终向身边人推荐它的原因。
1.3 下载镜像与安装前置检查
官网下载页面会跳到 CTAN 的各个镜像站,国内直连速度不稳定。我最常用的是这两个国内镜像:
- 清华大学 TUNA 镜像:https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/
- 中科大 USTC 镜像:https://mirrors.ustc.edu.cn/CTAN/systems/texlive/Images/
进入 Images 目录后找 texlive2020-20200406.iso,体积约 4.1GB,下载完建议顺手校验一下 SHA256,避免下载不完整导致安装到一半报错。Windows 下可以在 PowerShell 里执行:
Get-FileHash .\texlive2020-20200406.iso -Algorithm SHA256输出的哈希值和镜像站点给出的值对上,就可以放心用了。动手安装前,把下面这几项过一遍,能省掉后面一大堆麻烦:
- 安装目标盘剩余空间至少留出 10GB,系统盘也最好留出 3 到 5GB 的临时空间。
- 安装路径使用纯英文,不包含空格,比如 D:\texlive\2020。
- 当前 Windows 用户是管理员,或者至少能右键“以管理员身份运行”。
- 临时关闭 Windows Defender 实时保护,或第三方杀毒软件的实时防护,装完再开。
- 如果 Windows 用户名是中文,先看第 4.2 节,按那里的方法处理再动手。
2. TeX Live 2020 安装全程拆解:从 ISO 到命令验证
2.1 挂载镜像,找到安装入口
Windows 10 和 Windows 11 直接双击下载好的 ISO 文件,系统会自动挂载到虚拟光驱,并在资源管理器里分配一个盘符,打开就能看到里面有一堆文件和目录。如果系统比较老,或者双击后没有反应,可以右键选择“装载”,也可以用虚拟光驱软件挂载,再或者用 7-Zip 把 ISO 解压到一个纯英文目录里。
进入挂载出来的虚拟光驱后,找到 install-tl-windows.bat 这个文件。这是 Windows 下 TeX Live 的安装入口。这里要特别注意,不要直接双击,而是右键选择“以管理员身份运行”。这一步很重要,否则后续往系统环境变量写入路径时,可能因为权限不足被拒绝,进而引发各种奇怪的报错。
2.2 Advanced 模式里最重要的几个选项
安装器启动后,默认显示的是简单模式。简单模式下会直接按默认配置进行安装,默认路径是 C:\texlive\2020,这对我们来说显然不行。要点开界面下方的 Advanced 按钮,进入高级设置窗口,才能修改安装路径和相关参数。
在 Advanced 界面里,最核心的是 TEXDIR 这个字段,它决定 TeX Live 安装到哪个目录。把 C:\texlive\2020 改成 D:\texlive\2020,这一步就是把安装目标从系统盘挪到非系统盘的关键。路径务必保持纯英文,不要手滑写成 D:\软件目录\texlive 之类的含中文路径,不然 perl 脚本大概率闹脾气。
安装方案 scheme 这里,我强烈建议选 scheme-full。这是完整安装,包含所有宏包,虽然占空间最多,但后续不管写什么文档都不会遇到“缺少宏包”的尴尬。有些朋友为了省空间,想选 scheme-basic 或 scheme-medium,结果写中文论文时发现 ctex 等宏包缺失,还得临时用 tlmgr 补装,反而浪费更多时间。另外,安装器里面如果出现 “add to PATH” 之类的选项,务必保持开启;如果出现 “Create symlinks in standard system directories”,保持取消即可,手动控制 PATH 更干净。
设置完成后点 Install TeX Live,会弹出确认界面,检查一下路径和方案没问题,直接点安装。从这一刻开始,你就进入了漫长的等待阶段。
2.3 安装时间与安装过程中的注意事项
TeX Live 2020 的完整安装时间跨度很大。性能好的机器配 SSD,可能 20 到 30 分钟就完成;机械硬盘或性能一般的笔记本电脑,装到 50 分钟甚至一小时也不奇怪。所以开工前最好找个不会急着用电脑的时间段,免得装到一半想用电脑,进退两难。
安装过程中,界面日志会一直滚动,大量输出 “installing” 字样是正常现象,不要看到英文就以为报错。真正需要警惕的是日志长时间完全静止不动,比如卡在某个宏包超过十分钟没有任何新输出。大多数情况下这是磁盘 IO 卡住,或者杀毒软件在背后拦截进程,参考第 4 部分排查即可。另外,安装期间尽量不要让电脑进入休眠,也别强行关闭窗口,这会导致安装不完整,下次还得从头再来。
安装完成时,向导会显示 “Installed on” 之类的字样,同时开始菜单里会多出 “TeX Live 2020” 的文件夹。走到这一步,TeX Live 本体已经装完了,但还不能高兴太早,必须验证一下环境变量是否生效。
2.4 环境变量验证与编译测试
安装完成后,先别急着装 TeXstudio,更不能直接开始写文档,首先要确认命令能被系统找到。打开一个新的 CMD 窗口,注意是新开窗口,原来已经打开的 CMD 不会刷新环境变量,输入:
tex --version xelatex --version如果能看到版本号,说明安装程序已经把 D:\texlive\2020\bin\windows 加进了 PATH。如果提示“不是内部或外部命令”,说明 PATH 没配上,需要手动到环境变量里检查系统变量 Path 是否包含 D:\texlive\2020\bin\windows,没有就手动添加,然后重新打开 CMD 测试。
接下来做一次真正的编译测试。新建一个 test.tex,放在 D 盘某个英文路径下,内容写最简单的文档:
\documentclass{article} \begin{document} Hello, TeX Live 2020! \end{document}在 CMD 里切到该目录,执行:
xelatex test.tex命令运行后生成了 test.pdf,就说明整个 TeX 工具链已经通了。这个小小的验证动作,能帮你把“环境坏了”和“编辑器没配好”这两类问题彻底分开,后面排错会轻松很多。
3. TeXstudio 下载安装与关键配置
3.1 下载哪个安装包,如何装到非系统盘
TeXstudio 是目前最主流的 LaTeX 编辑器,装它才是真正把你从记事本写 LaTeX 的苦海里捞出来。官网是 https://www.texstudio.org/,点击 Download 会跳转到 GitHub Releases 页面,找 Windows 安装包,一般是以 .exe 结尾的文件,文件名类似 texstudio-4.8.x-win-qt6.exe。
版本选择上,如果电脑比较新,直接选 qt6 版本;如果是老电脑或者担心兼容性,选 qt5 版本。安装包一般只有一两百 MB,安装时可以自定义目录,建议直接指定到 D:\software\texstudio 这样的非系统盘路径,别让它默认装进 C 盘。安装过程中,勾选 “Associate .tex files” 是有用的,以后双击 .tex 文件就能直接用 TeXstudio 打开,其他快捷方式按需选择即可。
界面语言这里可以先选英文,因为进入软件后还能在设置里切换中文,完全不影响使用。安装完成后不要急着打开就开始写,先做编辑器与 TeX Live 的对接配置。
3.2 把 TeXstudio 和 TeX Live 对接起来
理论上,只要 TeX Live 的 bin 目录正确写入了 PATH,TeXstudio 启动时会自动检测到所有编译命令。第一次打开 TeXstudio,点一下新建文件,随便写几行,然后点菜单栏上的绿色播放按钮,如果能正常出 PDF,就说明连接成功了。
但实际环境里总有意外,最常见的情况是 TeXstudio 先于 TeX Live 安装,启动时拿不到当时的 PATH,导致编译按钮报错。这时需要手动指定命令路径。打开 Options -> Configure TeXstudio...,左侧选 Commands,把下面这些关键命令的路径填进去。注意路径分隔符建议统一用 /,反斜杠在设置文件里容易转义出问题。
| 命令 | 填写内容 |
|---|---|
| LaTeX | D:/texlive/2020/bin/windows/latex.exe |
| pdflatex | D:/texlive/2020/bin/windows/pdflatex.exe |
| xelatex | D:/texlive/2020/bin/windows/xelatex.exe |
| bibtex | D:/texlive/2020/bin/windows/bibtex.exe |
| biber | D:/texlive/2020/bin/windows/biber.exe |
| makeindex | D:/texlive/2020/bin/windows/makeindex.exe |
| dvips | D:/texlive/2020/bin/windows/dvips.exe |
| dvipdfmx | D:/texlive/2020/bin/windows/dvipdfmx.exe |
填完之后,OK 保存。如果此时默认编译器不是 XeLaTeX,顺手改成 XeLaTeX:回到 Configure TeXstudio,左侧选 Build,把 Default Compiler 改成 XeLaTeX。这一步对中文文档特别重要,不然后面写中文会一步一个坑。到这里,复杂的“LaTeX 连接 TeXstudio”工作就算完成了。
3.3 中文界面与中文文档编译方案
TeXstudio 要切换成中文界面,进入 Options -> Configure TeXstudio...,左侧 General,Language 一栏选 zh_CN,确定后重启软件,菜单就变成中文了。界面汉化只是第一步,真正考验人的是中文文档怎么编译,这里直接给一套最稳妥的方案:用 XeLaTeX 引擎搭配 ctex 宏包。
新建 .tex 文件时,先确认编辑器右下角的编码是 UTF-8。然后采用这样的最小模板:
\documentclass[UTF8]{ctexart} \title{一份中文文档} \author{作者} \begin{document} \maketitle 你好,LaTeX! \end{document}编译时在 TeXstudio 左上角工具条选 XeLaTeX,然后点编译。这样出来的 PDF 里中文显示完全正常。核心原因是 XeLaTeX 直接调用系统字体,而 ctex 宏包会智能检测 Windows 下的宋体、黑体、微软雅黑等字体,不需要你手动折腾字体配置。如果用的是论文模板,建议先看模板附带的说明文件,不少模板直接写明“请使用 XeLaTeX 编译”,你按这个走就对了。
3.4 中文词典:让拼写检查不再满屏红线
TeXstudio 默认的拼写检查词典是英文的,这导致一个很尴尬的体验:写中文注释时,编辑器把所有中文全部标成红色波浪线,看起来像全是拼写错误,非常干扰视线。解决思路有两个,我分别说。
第一个最简单,直接关掉拼写检查。进入 Options -> Configure TeXstudio... -> Editor -> Language Checking,把拼写检查相关的选项取消勾选。这样做对中文写作完全没影响,界面清爽很多,也是我自己在用的方案。
第二个是添加中文词典。如果你确实希望拼写检查能识别中文,可以下载 LibreOffice 或 OpenOffice 用的简体中文词典,需要 zh_CN.aff 和 zh_CN.dic 两个文件。把这两个文件复制到 TeXstudio 安装目录下的 dict 文件夹里,重启 TeXstudio,然后到 Language Checking 里的 Spelling dictionary 下拉框选择 zh_CN。选不上的话,可以手动指定 .dic 文件的完整路径。不过说实话,中文的拼写检查机制跟英文完全不同,即使词典装好了,也不能指望它像 Word 那样给你纠错,所以我的实际建议还是:关掉,图个清净。
4. 高频报错与排查实录
4.1 error while reading from perl back end 的完整排查
如果你是在搜索这个报错时点进来的,那大概率在 TeX Live 安装中后期遇到了红框报错。这个错误是标题里最热门的问题,也是很多新手第一次接触 TeX Live 就劝退的原因。报错内容的字面意思是“从 perl 后端读取数据时出错”,本质上是因为 TeX Live 安装器启动了一个 perl 进程来处理宏包安装和文件写入,装了一半 perl 进程异常退出,或者它和主安装程序之间的通信管道被中断,于是安装器报了这么一句话。
我这些年见过不少触发它的场景,按出现频率排序:杀毒软件实时防护拦截了子进程,导致管道断开;系统临时目录 TEMP 路径含有中文或权限不对;磁盘空间不足;ISO 镜像下载不完整;Windows 用户名是中文;安装时不是管理员身份。排查时可以按这个顺序一套下来:
| 可能原因 | 验证方法 | 解决办法 |
|---|---|---|
| 杀毒软件拦截 | 安装日志随机中断,关掉杀软后恢复 | 临时关闭防护,装完添加信任 |
| TEMP 路径含中文 | Win+R 输入 %TEMP% 看路径 | 设置 TEMP/TMP 为 C:\Temp |
| 磁盘空间不足 | 安装盘和系统盘容量告急 | 清理空间,至少留 10GB |
| ISO 镜像损坏 | 挂载后部分文件无法读取 | 校验 SHA256,重新下载 |
| 权限不足 | 未用管理员运行安装器 | 右键管理员身份运行 |
最有效的重置方式就是:先关杀毒软件,把 TEMP 和 TMP 指到纯英文目录,确认磁盘空间足够,然后右键管理员身份重新运行 install-tl-windows.bat。这一套组合拳能解决九成以上的 perl 报错,遇到这个问题时不要慌,按顺序来就行。
4.2 Windows 用户名是中文:如何安全过关
说到 TEMP 路径,就绕不开 Windows 用户名是中文这个经典坑。很多人的 Windows 账户名直接用了中文,于是用户目录是 C:\Users\张三 这样的路径。TeX Live 安装时大量临时文件和用户配置文件会落到用户目录下,而安装器内置的 perl 模块对非 ASCII 路径的支持并不完美,于是就会触发上一节说的 perl 错误,或者安装过程宏包写入失败。
遇到这种情况,最直接的方法是安装前把临时目录改掉。右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量,在用户变量和系统变量里都检查一下 TEMP 和 TMP,把它们改成 C:\Temp 的纯英文路径,并且提前创建好这个目录。改完记得把安装程序关掉重开,因为安装器读取环境变量是在启动的那一刻。
另外可以给当前用户设置一个英文的 HOME 环境变量。很多 TeX 工具链会使用 HOME 寻找配置文件和字体缓存,如果 HOME 默认指向 C:\Users\张三,含中文路径,后续用 tlmgr 更新宏包时也可能出问题。在环境变量里新建用户变量 HOME,值指向 D:\home 这样的英文目录并创建好,能规避很多隐藏问题。如果你的用户名中文问题已经严重到上述方案都救不回来,那就新建一个英文名的 Windows 管理员账户,在干净账户下完成安装,日常写文档也把工程文件放在英文路径下。
4.3 编辑器找不到编译命令 / 编译按钮是灰的
TeXstudio 编译时提示 “Could not start Build & View: xelatex.exe ...”,或者编译按钮是灰色不可点击,核心原因就一句话:编辑器找不到对应的编译器。先在 CMD 里试一下 xelatex --version,如果提示“不是内部或外部命令”,说明 TeX Live 的 bin 目录没加入 PATH,或者 PATH 配置不生效。这时手动把 D:\texlive\2020\bin\windows 加到系统环境变量 Path 里,关闭 TeXstudio 再重新打开。
如果 CMD 里命令正常,但 TeXstudio 还是找不到,那就是 TeXstudio 启动时缓存了错误的命令路径。到 Options -> Configure TeXstudio... -> Commands 里手动把 xelatex 等命令的完整路径填进去,按第 3.2 节的表格操作即可。这里还有个容易被忽略的点,命令路径如果有空格,比如 D:\Program Files...,一定要用双引号包住整个路径,否则程序会按空格把路径切断,自然启动失败。另外,不要同时安装 MiKTeX 和 TeX Live,两套发行版会在 PATH 里打架,编辑器经常定位到错误的 latex.exe,编译行为非常诡异。
4.4 中文 PDF 乱码、白板或方块字
编译明明成功了,但 PDF 里的中文全是空白、乱码或者小方块,这种问题几乎百分之百出在引擎或编码上。最常见的原因是用了 pdflatex 编译中文文档。pdflatex 对 UTF-8 编码的中文支持有限,不是不能做,但需要额外配合 ctex 的特定选项和字体设置,对新手来说完全没有必要折腾。直接用 XeLaTeX 才是正确的选择。
处理步骤很简单。第一,在 TeXstudio 的 Build 设置里把默认编译器改成 XeLaTeX。第二,确认 .tex 文件保存为 UTF-8 编码,最好不带 BOM。第三,用前面 3.3 节的最小中文模板测试,如果模板能出正常中文,那再回头检查你自己的文档设置。如果 ctex 宏包提示找不到字体,可以在导言区加一行:
\usepackage[fontset=fandol]{ctex}fandol 是 TeX Live 自带的中文字体集,使用它绕开系统字体的依赖,大多数情况下能立刻解决中文无法显示的问题。Windows 系统本身带宋体、黑体、微软雅黑,ctex 默认应该能自动找到,但如果你的系统精简过或者字体被优化工具误删,fandol 方案就是最稳的兜底。
5. 我的最后几点经验
装完这么多台电脑,我想把最实用的几条经验留在这。第一,装完 TeX Live 后的三分半钟,一定花在“新开 CMD 验证 xelatex --version + 编译一个最小文档”上,这个动作能帮你把环境问题和编辑器问题彻底分开,后面用 TeXstudio 时出任何状况,你都清楚该去哪排查。第二,TeXstudio 的三个省心设置一定要改:默认编译器选 XeLaTeX、拼写检查关掉、工作文件放英文路径。改完这三样,日常写文档的干扰因素能少一半。
第三点是关于重新安装的。如果你已经装过 TeX Live 但想换到非系统盘,不要直接卸载了事,先检查环境变量里是不是残留了旧路径,干净清理后再装新的。很多人的所谓“安装失败”,其实是旧版本的 bin 目录和新版本混在一起,PATH 乱了套。第四,tlmgr 是 TeX Live 的包管理器,装完以后定期在 CMD 里执行一下更新宏包索引,比到时候缺包临时抱佛脚要省心得多。
最后再分享一个小技巧,我在折腾 TeXstudio 时发现它的一些配置,包括命令路径、快捷键、主题,都保存在 %APPDATA%\texstudio\texstudio.ini 这个文件里。每次装好新环境,只要把这个文件备份一份,重装系统后复制回去,编辑器配置就全部恢复了,不用重新点一遍设置菜单。这个文件很小,却能省下不少重复劳动,建议大家在整套环境配好后顺手备份一次。