news 2026/9/18 19:22:06

TeX Live非系统盘安装教程:TeXstudio配置与中文支持全攻略

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
TeX Live非系统盘安装教程:TeXstudio配置与中文支持全攻略

如果你打开这篇博文,大概率正面临两件事:刚接触 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,把下面这些关键命令的路径填进去。注意路径分隔符建议统一用 /,反斜杠在设置文件里容易转义出问题。

命令填写内容
LaTeXD:/texlive/2020/bin/windows/latex.exe
pdflatexD:/texlive/2020/bin/windows/pdflatex.exe
xelatexD:/texlive/2020/bin/windows/xelatex.exe
bibtexD:/texlive/2020/bin/windows/bibtex.exe
biberD:/texlive/2020/bin/windows/biber.exe
makeindexD:/texlive/2020/bin/windows/makeindex.exe
dvipsD:/texlive/2020/bin/windows/dvips.exe
dvipdfmxD:/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 这个文件里。每次装好新环境,只要把这个文件备份一份,重装系统后复制回去,编辑器配置就全部恢复了,不用重新点一遍设置菜单。这个文件很小,却能省下不少重复劳动,建议大家在整套环境配好后顺手备份一次。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/9/18 19:21:01

基于KDD99数据集的神经网络入侵检测与特征分析

简介:这份基于机器学习的网络入侵检测方法PDF是一篇来自《湖南工业职业技术学院学报》的学术文献,面向网络安全研究者、高校师生及机器学习入门者,重点探讨如何利用机器学习算法识别和应对日益复杂的网络入侵攻击。资源仅包含1个PDF文档&…

作者头像 李华
网站建设 2026/9/18 19:20:37

Spark Job aborted与stage failure排查

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华