如果你打开这篇博文大概率正面临两件事刚接触 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 或 256GBWindows 系统、软件、桌面文件堆一堆再硬塞一个 TeX LiveC 盘很快见红。把发行版装到 D 盘或 E 盘这件事可以一次做对以后不用返工。第二条理由是重装系统的场景。装在非系统盘哪天系统崩溃要重置 WindowsD 盘上的 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 目录正确写入了 PATHTeXstudio 启动时会自动检测到所有编译命令。第一次打开 TeXstudio点一下新建文件随便写几行然后点菜单栏上的绿色播放按钮如果能正常出 PDF就说明连接成功了。但实际环境里总有意外最常见的情况是 TeXstudio 先于 TeX Live 安装启动时拿不到当时的 PATH导致编译按钮报错。这时需要手动指定命令路径。打开 Options - Configure TeXstudio...左侧选 Commands把下面这些关键命令的路径填进去。注意路径分隔符建议统一用 /反斜杠在设置文件里容易转义出问题。命令填写内容LaTeXD:/texlive/2020/bin/windows/latex.exepdflatexD:/texlive/2020/bin/windows/pdflatex.exexelatexD:/texlive/2020/bin/windows/xelatex.exebibtexD:/texlive/2020/bin/windows/bibtex.exebiberD:/texlive/2020/bin/windows/biber.exemakeindexD:/texlive/2020/bin/windows/makeindex.exedvipsD:/texlive/2020/bin/windows/dvips.exedvipdfmxD:/texlive/2020/bin/windows/dvipdfmx.exe填完之后OK 保存。如果此时默认编译器不是 XeLaTeX顺手改成 XeLaTeX回到 Configure TeXstudio左侧选 Build把 Default Compiler 改成 XeLaTeX。这一步对中文文档特别重要不然后面写中文会一步一个坑。到这里复杂的“LaTeX 连接 TeXstudio”工作就算完成了。3.3 中文界面与中文文档编译方案TeXstudio 要切换成中文界面进入 Options - Configure TeXstudio...左侧 GeneralLanguage 一栏选 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 路径含中文WinR 输入 %TEMP% 看路径设置 TEMP/TMP 为 C:\Temp磁盘空间不足安装盘和系统盘容量告急清理空间至少留 10GBISO 镜像损坏挂载后部分文件无法读取校验 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[fontsetfandol]{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 这个文件里。每次装好新环境只要把这个文件备份一份重装系统后复制回去编辑器配置就全部恢复了不用重新点一遍设置菜单。这个文件很小却能省下不少重复劳动建议大家在整套环境配好后顺手备份一次。