ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

TeX Live 2020 非系统盘安装详解:TeXstudio配置与XeLaTeX中文环境

TeX Live 2020 非系统盘安装详解:TeXstudio配置与XeLaTeX中文环境 1. 装非系统盘到底图什么三个真实场景和我的判断不少人一搜“TeX Live 2020安装”就冲向默认安装结果把几 GB 的宏包、字体和文档全堆进 C 盘。等 C 盘变红再想起来搬家往往得重装一次。我第一次折腾 TeX Live 的时候也是默认路径后来换固态硬盘才认真把非系统盘安装的流程过了一遍。先说结论TeX Live 2020 和 TeXstudio 装在 D 盘这类非系统盘上不是装完就一劳永逸但确实是很多场景下的正确选择。判断标准不是“能不能装”而是“你重装系统之后还想不想保留这套环境”。我的本机情况是这样的系统盘是一块 256GB 的固态装完 Windows、Office、开发环境和常用软件剩余空间长期在 30GB 上下徘徊。TeX Live 2020 的完整方案装完之后接近 7GB再加上编译缓存和后续 tlmgr 更新占的空间会进一步膨胀。如果全装在 C 盘等于用系统盘空间换编译环境对我的日常使用来说压力不小。适合把 TeX 环境放到非系统盘的真实场景我归纳出这三类第一类C 盘空间本来就紧张。256GB 或 512GB 系统盘装完大型软件后剩余空间不多TeX Live 这种体积大户放在 D 盘或 E 盘更合理。第二类电脑是单位公用机或者实验室机器C 盘有还原保护或定期巡检清理。你把软件装到非系统盘重启之后环境还在不需要反复重装。第三类你自己经常折腾系统。重装 Windows 前只要 D 盘没被格式化TeX Live 2020 的安装目录和 TeXstudio 的安装程序都还在。重装之后重新配一下系统 PATH等于瞬间恢复编译环境省去了重新下载和长时间安装的步骤。这里要纠正一个常见的误解把 TeX Live 装到 D 盘之后它并不是一个绿色软件。TeX Live 会往系统里写入环境变量TeXstudio 的用户配置文件默认存到%APPDATA%目录。所以你做不到“把 D 盘拷走插到别的电脑直接用”。真正完全免安装的方案是用 TeXstudio 的便携模式配合可移动目录但那个方案牺牲了系统集成性日常写文档会踩更多坑。我建议的路线是TeX Live 2020 本体装在非系统盘通过系统 PATH 让全局命令可用TeXstudio 也装在非系统盘负责编辑和编译预览。这样既避开 C 盘空间问题又不牺牲命令行直接操作 TeX 工具链的能力。2. 安装包准备版本抉择、下载渠道与文件校验很多教程直接丢一个“TexLive2020下载”链接让你点。但你该知道自己在下载什么以及 2020 这个版本在 2025 年还值不值得装。先说版本。TeX Live 每年发布一个新版功能迭代和宏包更新很频繁。2020 版在当年是一个稳定版本现在依然能正常编译绝大多数 LaTeX 文档。如果只是因为学校课程、出版社模板或者老师指定要用 2020 版本那直接用没问题。如果你没有任何历史包袱只是为了写论文、做幻灯片建议下载最新版本安装流程和 2020 几乎一致只是界面细节和文件名版本号不同。这篇文章的全部操作都以 TeX Live 2020 为基础新版本照着做也大差不差。下载渠道的选择非常关键。TeX Live 最权威的来源是 CTAN 镜像但国内直连速度不稳定。国内高校镜像站点里清华 TUNA 和中科大 USTC 镜像是我用得最多的。在清华镜像的texlive/images目录下你会找到texlive2020.iso这个文件完整版 ISO 大小在 4GB 左右。如果你网络条件好直接下载 ISO 然后解压或者挂载都行。如果网速一般镜像站也提供 install-tl-windows.exe 网络安装程序下载体积只有几 MB运行时再拉取宏包内容。不过对于 2020 这种完整版镜像我更推荐下载 ISO因为一次下载的内容是完整的之后真正安装时不再依赖网络速度。再说一个很多人忽略的步骤校验文件。镜像站会同时提供.sha512校验文件大型文件在下载过程中因为网络抖动很容易出现坏块。我见过不止一次因为 ISO 下载不完整安装到一半报“文件无法读取”或者“tar 解压失败”的情况。校验方法很简单打开 PowerShell输入Get-FileHash .\texlive2020.iso -Algorithm SHA512把输出的哈希值和镜像站给的值对比。一致说明文件完整不一致重新下载。TeXstudio 的安装包就小巧多了官方下载页面提供 Windows 安装程序版本上选择与你系统位数匹配的 64 位版本即可。TeXstudio 安装包通常只有几百 MB 级别具体数值随版本变化下载时注意看文件后缀带_win的就是 Windows 版。3. TeX Live 2020安装过程详解每步选项的含义与取舍3.1 运行安装程序之前的准备工作拿到texlive2020.iso后先在 Windows 资源管理器里右键挂载 ISO或者用解压软件全部解压出来。重点安装目录不要带中文和空格。我说的是D:\texlive\2020这种路径不要弄成D:\软件\TeX 2020。中文和空格在 TeX 工具链的历史版本里出过很多诡异问题虽然新版兼容性有所改善但没必要给自己添麻烦。然后右键这个install-tl-windows.bat文件选择“以管理员身份运行”。这一步不能省因为安装程序需要写系统环境变量。如果不以管理员身份运行多半会弹出权限错误或者装完了 PATH 没有更新。安装前还有一个容易被杀毒软件拦下来的环节。TeX Live 安装程序包含大量脚本和可执行文件某些杀毒软件会对其中部分文件报毒或者静默隔离。安装期间最好暂时关闭实时防护或者把整个D:\texlive目录加入白名单。等安装完成后编译正常使用没问题再把实时防护打开。3.2 安装向导界面我建议你点开“Advanced”看看双击运行后如果一切正常会弹出 TeX Live 安装图形界面。默认界面很简单顶部是安装路径信息底部只有开始安装的按钮。很多人直接点“安装”结果装到 C 盘去了。正确操作是先点界面里的“Advanced”按钮展开高级配置项。这不是什么危险选项恰恰是控制安装位置和方案选择的入口。高级界面下“Directories”面板里有三个路径最关键的是第一项 TEXDIR也就是 TeX 系统的主安装目录。默认值是C:\texlive\2020把它改成D:\texlive\2020。另外两项 TEXMFLOCAL 和 TEXMFHOME 也可以一并放在 D 盘完整路径建议这样设置TEXDIR:D:\texlive\2020TEXMFLOCAL:D:\texlive\texmflocalTEXMFHOME:D:\texlive\texmfhomeTEXMFLOCAL 和 TEXMFHOME 分别是本地宏包目录和用户宏包目录。默认情况下它们其实已经位于用户个人目录下其实并不占 C 盘多少空间但你既然决定把 TeX 环境整体放到 D 盘建议也一起改过去方便以后整体备份。3.3 方案和宏包集合到底选 full 还是省空间安装方案Scheme决定你装哪些宏包集合。TeX Live 2020 提供的方案从大到小有完整、标准、推荐、基本、最简五个级别。“完整”对应scheme-full安装全部宏包集合“最简”对应scheme-minimal只保留核心编译引擎。我的经验第一次安装尤其是在不确定以后需要什么宏包的情况下直接选full完整方案。原因很简单完整方案真正帮你节约的是时间。写论文时随手用到的宏包比如ctex、amsmath、graphicx、hyperref、booktabs这些全都在完整安装里预先装好了。缺省方案装完等你在文档里引用一个没安装的宏包时编译直接报File not found你还得去查 tlmgr 装依赖这个时间成本远比多占几 GB 硬盘空间高。完整方案和标准方案的实际大小差异大概在两三 GB 左右。考虑到你专门选择非系统盘安装本来就是为了释放 C 盘压力那在 D 盘多占几 GB 也不是问题。选好方案后下面会展开一个宏包集合列表默认勾选了对应方案的所有项。除非你明确知道某个集合没用否则不要动这个列表。我曾经为了省空间取消了几项字体集合后来编译参考文献时缺一个特殊字体查了半天才装上。3.4 点击安装之后的那些细节路径和方案都确认无误后界面底部应该能看到类似“Install TeX Live”的按钮点击即开始安装。安装时间取决于你的硬件。机械硬盘上跑完整方案可能需要四十分钟到一个小时固态硬盘会快不少但通常也超过二十分钟。这期间进度条边上的日志会一直滚动显示正在安装哪个宏包。如果你看到某个宏包名反复出现或者某一步卡住超过十分钟多半是杀毒软件拦截了去白名单里检查一下。安装完成后日志最后会输出一行包含“successfully installed”的结果信息。此时先不要急着关窗口检查一下安装日志里有没有提到“Adjusting PATH”或者修改环境变量的信息。如果日志显示 PATH 未更新那就需要手动添加。手动添加路径的方法右键“此电脑” → “属性” → “高级系统设置” → “环境变量”在系统变量列表里找到Path点击编辑新建一行填入D:\texlive\2020\bin\win32保存后打开一个新的命令提示符窗口输入tex --version能显示 TeX Live 2020 的版本信息就说明环境配置成功。4. TeXstudio安装与集成路径规划和中文环境配置4.1 TeXstudio的安装流程TeXstudio 的安装包是正常的 Windows 安装向导界面双击运行后一路 Next 就能装完但安装位置需要手动改。默认路径在 C 盘我建议直接把安装目录改成D:\texstudio简单干净和 TeX Live 目录放在同一个盘符下日后备份迁移的时候一条命令就能把整个目录结构带走。安装过程中有一个组件选择的界面里面有“附加桌面图标”和“关联文件类型”之类的选项。我的建议是保留默认勾选特别是文件关联。安装完成后双击.tex文件就能直接用 TeXstudio 打开这个便利性非常重要。4.2 配置编译器核心是把 xelatex 用起来TeXstudio 装好后首次启动会问你是否允许自动检测 TeX 发行版。如果你在前面正确配置了系统 PATH它通常能自动找到 TeX Live 2020 的pdflatex.exe和xelatex.exe等工具。如果没有找到就要手动配置。进入“选项”菜单 → “配置 TeXstudio” → “命令”选项卡。这里有一堆字段LaTeX对应的值默认是pdflatex.exeXeLaTeX对应的是xelatex.exe。如果这些可执行文件无法被 TeXstudio 自动定位直接把它改成绝对路径D:\texlive\2020\bin\win32\xelatex.exe这里请记住一个基本事实无论你在 TeXstudio 里选择PDFLaTeX还是XeLaTeX实际调用的都是 TeX Live 目录下 bin 文件夹里的程序。所以 PATH 配置的问题不解决TeXstudio 里的所有配置都是空中楼阁。4.3 中文环境的正确打开方式网上有大量“Texstudio 添加中文词典”的教程那是给拼写检查功能用的。如果你只是想正确编译中文 LaTeX 文档核心不是词典而是两点使用ctex宏包并且用 XeLaTeX 编译器。打开“配置 TeXstudio”→“构建”→“默认编译器”把PdfLaTeX改成XeLaTeX。这里我想额外说明如果文档里只使用英文PdfLaTeX 完全够用。但是中文文档必须走 XeLaTeX因为ctex宏包在 XeLaTeX 下会调用系统字体机制处理中文断行和标点压缩的效果比传统方式好太多。新建一个测试文档test.tex内容如下\documentclass{article} \usepackage[UTF8]{ctex} \title{非系统盘安装测试} \author{Your Name} \begin{document} \maketitle 你好世界。Hello, World. \end{document}在 TeXstudio 里按 F5 或点击“编译并查看”如果生成了包含中英文混排的 PDF就说明整套环境已经工作正常。段落字号调整小技巧TeXstudio 编辑器字体默认偏小在“选项”→“设置”→“编辑器”里把字体调到 14 或 16长时间写文档会轻松很多。这些细节不影响编译但直接影响使用体验。5. 安装完成后的验证流程和常见报错排查5.1 命令行验证比界面更可靠很多时候 TeXstudio 界面上报错根源不在编辑器而在系统环境变量。我强烈建议你先脱离 TeXstudio单独在命令行里做一轮验证。打开命令提示符依次执行这几条命令tex --version xelatex --version pdflatex --version tlmgr --version每一条都能正常输出版本信息就说明 TeX Live 2020 的二进制文件在你机器上可以被正常调用。特别是tlmgr它是 TeX Live 的包管理器以后安装缺失宏包全靠它。如果哪一条报“不是内部或外部命令”基本就是 PATH 没配好或者配置后没有重开终端。改完 PATH 后旧窗口不会自动刷新环境变量一定要开新窗口再试。5.2 第一个文档的完整编译路径验证完命令行工具再用命令行手动编译一次文档。在 D 盘创建一个纯英文路径的工作目录比如D:\work把上面的test.tex放进去执行cd /d D:\work xelatex test.tex第一次编译时xelatex 可能会生成多个辅助文件还会因为字体缓存建立而略慢这是正常现象。编译结束后目录下会多出test.pdf。如果这一步成功说明 TeX Live 2020 核心功能完全正常之后 TeXstudio 的任何问题都只在编辑器配置层面了。5.3 TeXstudio 找不到编译器的排查套路遇到过很多次这种情况命令行编译一切正常但 TeXstudio 一按 F5 就报“未找到 pdflatex”。先别急着重装这通常是这几个原因之一。原因一TeXstudio 是在 PATH 配置完成之前启动的。Windows 应用读取环境变量是在启动时完成的如果你先启动了 TeXstudio再改 PATHTeXstudio 里的进程环境还是旧的。解决办法最直接完全退出 TeXstudio确认任务管理器里没有texstudio.exe残留进程再重新打开。原因二TeXstudio 配置里手动填了错误的路径。有些教程让人在“命令”选项卡里填pdflatex而不是pdflatex.exe这会因为缺少后缀导致查找失败。把命令字段改回带.exe的完整名称就正常了。原因三系统环境变量和用户环境变量冲突。我有一台测试机器曾经安装过老版本的 TeX LiveC 盘里残留了一个C:\texlive\2019\bin\win32系统 PATH 里它的位置排在 D 盘 2020 之前。结果命令行里虽然显示的是 2020 版本但 TeXstudio 可能调用到旧版本的 dll导致各种奇怪报错。排查办法是在命令提示符里执行where xelatex输出结果的第一行就是当前系统实际调用的程序路径。如果显示的不是D:\texlive\2020\bin\win32\xelatex.exe就需要去环境变量里调整顺序把新路径往上移。5.4 编译过程中的其他坑路径问题是最大的坑池。即使你的 TeX Live 安装在D:\texlive\2020这样一个没问题的地方文档本身也尽量放在英文路径下。我的建议是不要用D:\学习资料\论文新建文件夹之类的路径尤其是文件夹名中间带空格或中文的目录。XeLaTeX 在近年版本里对中文路径的兼容性已经改善但仍然不值得拿一篇重要论文去赌这个兼容性。还有一个在新手阶段很容易踩的坑是安全类软件的主防拦截。tlmgr 更新宏包时会释放大量小文件并修改目录结构这个过程可能触发主防提示。如果你在安装和更新过程中遇到莫名其妙的“操作失败”或者“权限不足”先检查安全中心的隔离记录。下面是几个高频报错和对应的处理建议我平时指导同事用的就是这张表报错现象可能原因处理办法提示xxx not foundPATH 缺失或路径错误用where命令检查实际调用的程序位置编译时找不到.sty文件缺少某个宏包tlmgr install 宏包名安装缺失包中文乱码或方块没有用 XeLaTeX或缺少字体把编译器换成 XeLaTeX确认系统有中文字体编译过程卡死不动杀毒软件拦截将 D:\texlive 加入白名单后重试安装时提示拒绝访问权限不足右键安装程序以管理员身份重新运行6. 长期使用视角体积控制、增量更新与备份迁移TeX Live 2020 安装完之后体积已经不小了但后续 tlmgr 更新还会让体积继续增长。这里有一个现实问题你需要定期更新宏包吗我的看法是如果你只是为了写课程论文、毕业设计或者日常文档不需要追新装好之后稳定用大半年完全没问题。如果你投的期刊要求某个宏包的最新版本那再针对性更新也不迟。真要更新的时候控制台执行tlmgr update --self tlmgr update --all--self先更新 tlmgr 自身然后再更新全部宏包。完整更新一次可能要下载几百 MB 的内容速度取决于镜像站的连接质量。如果只想更新单个宏包比如ctextlmgr update ctex如果更新完发现某些文档编译不过大概率是宏包版本升级导致的兼容性问题。此时可以用tlmgr restore 宏包名回滚到更新前的版本这是 TeX Live 给用户的后悔药。关于备份和迁移我有一套自己的做法。整套 TeX 环境的精华都在D:\texlive目录下你只需把这个目录连同D:\texstudio备份到移动硬盘或者 NAS。重装系统后照着以下三步做能快速恢复把备份目录还原到目标机器的 D 盘路径保持完全一致。手动添加D:\texlive\2020\bin\win32到系统 PATH。安装或直接运行D:\texstudio\texstudio.exe确认编译器路径指向D:\texlive\2020\bin\win32\xelatex.exe。这里要特别强调路径必须一致。TeX 的系统配置文件和宏包缓存里记录了安装位置路径变了还得重新配置 tlmgr 的 repository 路径麻烦得很。如果你迁移时非改路径不可最省事的方法是用官方安装包在目标位置重新安装一遍然后把旧D:\texlive\texmflocal目录复制过去——这一步能保留所有手动安装的本地宏包。换个机器直接拷目录能不能用能但前提是目标机器的系统环境干净没有任何旧版 TeX 残留。我试过在一台全新系统上直接运行 D 盘搬来的 TeXstudio配合正确 PATH日常编译没有问题。但在有残留环境的机器上就可能遇到前面提到的 PATH 顺序、版本冲突问题。最后分享一个小习惯我会在D:\work底下放一个名为template的模板目录里面放好固定格式的中文论文模板和自定义宏包。每次写新文档直接复制模板目录改里面的内容即可。这样既绕开了路径问题又能把常用宏包集中管理。TeX 环境的搭建本质上是把工具链装好而已——绝大多数编译报错不是硬件的错也不是 macOS 或 Windows 的错而是路径和环境变量这两件事上出了偏差。把这些基础打牢Texlive2020 和 TeXstudio 在非系统盘上的使用体验基本和 C 盘布局的安装没有任何区别。
返回列表