每到 TeX Live 出新版的时间群里总有人问同一件事Windows 上到底怎么装 TeX Live 2026说实话官方已经把这个流程做得足够傻瓜化但每年还是有人栽在旧版本残留、网络中断、磁盘空间和 PATH 这几道坎上。这篇就把我从下载到日常使用的完整流程按实际操作的顺序写出来照着做基本能一次过适合第一次接触 TeX Live 的纯新手也适合已经装了旧版想迁移的朋友。1. 安装前准备清理旧版本与检查系统安装 TeX Live 2026 本身不难但很多人开局就踩坑原因不是不会装而是机器上已经有旧版本或者目录、权限、磁盘空间没准备好。这部分看起来啰嗦实际能省掉后面一堆编译报错。1.1 TeX Live 2026 到底带来了什么值得升级吗TeX Live 是每年发布一个完整发行版的 LaTeX 套件2026 版照例包含大量宏包更新包括 LaTeX 内核、CTeX 中文支持、字体配置和一些排版引擎的修复。作为长期用 LaTeX 写论文、做讲义的用户我的习惯是每年新版本发布后稳定一个月再换因为新包往往也意味着新依赖和潜在的兼容性变化。如果你当前用的是 2024 或更新版本不影响继续使用但如果要投期刊期刊模板通常要求某个 TeX Live 版本以上装 2026 能避免“宏包版本太旧导致模板编译不过”的问题。另外2026 的安装器对 Windows 10/11 的支持更稳安装时对用户权限、路径中文字符的容错也比以前好但下面这些坑还是得手动避。1.2 卸载旧版本的正确姿势很多人的电脑上同时躺着 TeX Live 2023、2024、2025甚至还有旧的 MikTeX。这样不是不行但环境变量 PATH 里最先找到哪个版本命令行里用到的就是哪个版本很容易出现“同一个文件两个编译结果不同”的诡异问题。如果决定换到 2026推荐先把旧版卸干净。以 TeX Live 为例官方提供了卸载脚本进入旧版安装目录例如D:\texlive\2025\tlpkg\installer\uninstall-tl.bat右键以管理员身份运行等待清除完成。千万别直接从文件夹里删因为注册表里的卸载信息和 PATH 环境变量不会自动清理。卸载后再手动检查一下环境变量。按 Win 键搜索“编辑系统环境变量”打开后查看 Path 里有没有残留的C:\texlive\2024\bin\windows这一类条目有就删掉。这一步经常被忽略但干净的系统会让后面排查问题快很多。1.3 系统需求与磁盘空间预留TeX Live 2026 安装完整方案需要不少空间官方给出的推荐值是 8GB 左右实际使用中我见到的完整安装多在 79GB 之间。内存要求不高4GB 也能跑但编译大文档时建议 8GB 以上否则经常出现内存不足引起的莫名卡顿。项目建议配置操作系统Windows 10 / 11 64 位内存最少 4GB推荐 8GB 以上磁盘空间完整安装预留至少 10GB权限安装过程需管理员权限安装路径建议不要带空格、不要带中文。官方默认路径是C:\texlive\2026如果你实在想装到 D 盘写成D:\texlive\2026也可以避免使用D:\Program Files\texlive\2026这种带空格的路径。Windows 下 TeX 工具链对空格和中文字符的兼容性时好时坏能躲就躲。2. 获取安装包镜像选择与安装源配置这一步是很多人安装失败的源头。明明宽带很快下载过程却反复卡住最后不得不放弃问题多半出在安装源上。2.1 从哪个地址下载最靠谱TeX Live 官方网站提供的下载入口是install-tl.zip里面包含 Windows 下的安装脚本install-tl-windows.bat。官网本身没有任何问题但实际下载安装包时TeX Live 会从配置的仓库拉取所有宏包数据这个仓库的速度决定了安装体验。我的建议是官网下载安装器然后把安装源指向国内镜像。常见镜像见下表镜像站仓库地址清华 TUNAhttps://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet中科大https://mirrors.ustc.edu.cn/CTAN/systems/texlive/tlnet阿里云https://mirrors.aliyun.com/CTAN/systems/texlive/tlnet下载时要注意这里给的是 2026 年发布通道的 tlnet 地址如果你拿到的是 2025 年版本的镜像地址安装器可能会报错或装出旧版。以安装器内的提示为准。2.2 为什么强烈推荐“网络安装器 镜像源”install-tl.zip只有几 MB本质上是个引导器运行后会按你选择的方案从仓库下载并安装所有宏包。另一种方式是下载完整 ISO 镜像离线安装但 ISO 体积通常超过 5GB下载时间长而且安装后一样要联网更新优势不大。网络安装最大的好处是可以随时断点重试。实测装到一半如果断网重新运行安装脚本不会把所有东西从头下载一遍已下载完成的包会缓存起来速度损失很小。前提是不要频繁强制关闭安装窗口耐心等它自己报错或完成。2.3 校验文件与解压路径细节如果你在意下载完整性可以去官网拿到安装包的 SHA256 校验值在 PowerShell 里运行Get-FileHash .\install-tl.zip比对一下。这一步不是必须的但能避免下载损坏造成的诡异安装失败。解压时务必将目录放到一个稳定且短的位置比如C:\install-tl而不是解压到桌面或下载目录。原因很简单安装过程中会创建临时文件如果目录层级太深或者中间有空格个别 Windows 环境下的脚本会出问题。解压后确认能看到install-tl-windows.bat这个文件再继续下一步。3. 实战安装从双击到验证成功前面准备都做好后安装本身反而没什么难度。这一节是核心操作流程建议每一步都按顺序执行不要跳。3.1 使用 install-tl-windows.bat 启动安装进入解压后的目录找到install-tl-windows.bat右键选择“以管理员身份运行”。首次运行时Windows SmartScreen 可能会弹出蓝色警告提示“Windows 已保护你的电脑”这是因为该脚本没有微软签名。点击“更多信息”再点“仍要运行”不要因为这个就把安装放弃。如果双击后没反应大概率是你没有安装 Perl 或者系统权限不够。TeX Live 安装器的主体其实依赖 Perl 运行但 Windows 版的批处理脚本会调用自带的 Perl 模块一般不需要你单独装 Perl。此时可以先在 PowerShell 里执行Set-ExecutionPolicy Unrestricted试试但更常见的解决办法是确认当前用户属于管理员组且已经右键管理员运行。启动后会出现安装界面界面语言取决于系统区域设置。看到界面就说明安装器正常烧起来了。3.2 安装方案scheme选择新手到底该装多少安装界面里最关键的选项是Select scheme也就是选择安装方案。可选方案包括full scheme完整安装、medium scheme、small scheme、minimal scheme以及basic scheme。我给新手的建议非常直接选full scheme。完整安装虽然占用空间大但胜在“以后基本不用为缺宏包发愁”。LaTeX 的宏包依赖关系比大多数人想象的复杂某个包可能依赖另外两三个包少了就编译不过临时再装又容易遇到版本依赖问题。与其纠结装哪些不如一次到位。老手如果磁盘紧张可以只选medium scheme再在下面的集合里勾选需要的功能比如collection-langchinese、collection-latexrecommended、collection-bibtexextra。但这里有个常见误区你觉得自己只写中文文章其实还要用到各种图表包、参考文献包、beamer 幻灯片包精简到最后反而处处受限。下图是我常用的方案经验表方便参考使用场景推荐方案新手、论文写作、日常排版full scheme磁盘紧张但需要中文支持和基本 LaTeXmedium scheme 勾选中文集合只需要 pdflatex 快速编译不需要中文small scheme服务器或 CI 环境只为了跑格式检查minimal scheme3.3 安装耗时与磁盘占用实测点击开始安装之后界面会列出当前方案需要的包数量和总大小。以 full scheme 为例2026 版通常有四千多个宏包下载量在 4~5GB 左右。在网络正常的情况下我用国内镜像实测大约 40 分钟装完如果网络波动可能延长到一个多小时。安装过程中界面看起来像“卡住”了经常有朋友截图问我是不是死机。实际上它只是在下包或者解压进度条更新不频繁。判断是否真卡死的方法是看磁盘活动打开任务管理器如果perl.exe或install-tl.bat还在占用 CPU 或磁盘就说明还在工作不要强行关掉。安装完成后安装器会显示“successfully installed”或类似提示同时自动将C:\texlive\2026\bin\windows写入用户环境变量 PATH。但这里有个坑这个 PATH 只在“之后新开的终端”里生效已经在运行的 PowerShell 或 CMD 不会自动识别。所以哪怕提示安装成功你也必须先关掉旧终端重新开一个。3.4 验证安装成功tex --version / latex --version打开一个新的 PowerShell 窗口输入tex --version如果输出类似TeX 3.141592653...的版本信息说明 TeX 引擎已经可用。再试试latex --version xelatex --version lualatex --version这几个命令分别是默认编译器、中文常用的 XeLaTeX、以及 LuaLaTeX。如果你输入后系统提示“找不到命令”大概率是 PATH 没生效或者安装路径不在 PATH 里。手动检查环境变量按Win R输入sysdm.cpl进入“高级”选项卡点击“环境变量”在用户变量和系统变量里找到 Path确认存在C:\texlive\2026\bin\windows。如果没有手动新增并保存然后重新打开终端验证。4. 安装后的更新tlmgr 与宏包管理很多人以为装完就能用了其实 TeX Live 安装包只是那一刻的快照宏包仓库每天都有更新。尤其你安装如果用的是较早的镜像某个包可能已经落后了几个 fix所以更新是必做的一步。4.1 更新 tlmgr 本体在 PowerShell 里输入tlmgr update --selftlmgr是 TeX Live 官方的宏包管理器相当于 LaTeX 世界的“软件包管理器”。安装器自带的 tlmgr 版本可能比仓库里的旧直接更新宏包有时会提示需要先更新自身所以第一步永远是--self。这里有一个 Windows 专属的权限问题如果你的 TeX Live 装在C:\texlive\2026这种需要管理员写入的位置那么 tlmgr 命令必须以管理员身份运行否则会报权限不足但如果安装在用户目录普通权限反而更合适。我的习惯是全局安装时就直接用管理员 PowerShell 执行所有 tlmgr 命令。4.2 设置或更换合适的更新源如果tlmgr update --self非常慢说明当前源不是你想要的源。可以用下面的命令修改更新仓库tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet设置后执行tlmgr update --all完整更新 full scheme 的包通常也要下载 500MB 以上取决于安装时间。更新期间如果网络中断重新执行同一条命令即可tlmgr 会自动跳过已经完成的包。4.3 宏包更新失败后的回退策略更新宏包不是永远顺风顺水的。最典型的场景某天ctex宏包更新后你的文档突然编译报错而前一天还能正常编译。不要慌tlmgr 每次更新前会在C:\texlive\2026\tlpkg\backups保留旧的压缩包你可以回滚到更新前的版本。先查看该宏包的历史备份tlmgr restore ctex它会列出可回退日期选择对应的备份编号即可恢复。这个机制被很多人忽略但它真的是 LaTeX 用户的救命稻草。我建议每次大批量更新后先编译一下自己最常用的文档确认没问题再继续写避免踩在边缘版本上。5. 编辑器与编译工作流配置引擎装好只完成了一半真正决定使用体验的是编译器和编辑器的配合。这一节说一下我实际用的方案以及新手常踩的编译按钮坑。5.1 TeXworks 里怎么选编译器TeX Live 自带 TeXworks 编辑器界面朴素但能用。关键点不在编辑器而在左上角的“排版”下拉菜单如果你写的是中文文档千万不要选latex或pdflatex要选XeLaTeX或LuaLaTeX。为什么因为新一代中文字体支持和部分字体功能依赖 XeTeX 引擎。pdflatex虽然也能通过 CJK 包处理中文但字体切换、PDF 中文书签、复制搜狗等体验都不如 XeLaTeX 方便。现在大多数中文 LaTeX 模板都默认要求 XeLaTeX 编译记住这一点能少走一半弯路。如果用的是 VS Code 替代 TeXworks先安装扩展LaTeX Workshop然后在settings.json里添加以下核心配置{ latex-workshop.latex.recipes: [ { name: xelatex, tools: [xelatex] } ], latex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] } ] }这里需要解释一下参数-interactionnonstopmode表示遇到错误时不暂停等待输入而是在日志里打印错误后继续适合自动化编译-synctex1开启同步定位方便正向跳到文档对应位置-file-line-error让错误信息带上文件名和行号排查时能直接点击跳转。5.2 VS Code 自动清理临时文件配置每次编译都会产生.aux、.log、.out、.toc等中间文件。XeLaTeX 编译时也会生成.xdv文件这些文件不清理会越来越乱。可以在settings.json里增加latex-workshop.latex.clean.fileTypes: [ *.aux, *.log, *.out, *.toc, *.xdv, *.synctex.gz, *.fls, *.fdb_latexmk ]注意auto clean功能默认会在每次编译成功后删除这些文件。好处是目录清爽坏处是你可能一时找不到编译日志排查错误时反而少信息。我个人习惯是关闭自动清理只在需要提交文件时手动执行因为 Windows 上很多报错信息都在 .log 文件尾巴上删了就真找不回来了。5.3 中文编译与字体配置Windows 上中文排版的标配是ctex宏包。在导言区写\documentclass[UTF8]{ctexart} \begin{document} 你好LaTeX。 \end{document}然后选择 XeLaTeX 编译。CTeX 会自动调用系统中文字体比如 Windows 的宋体、黑体、楷体。如果编译时报错说找不到字体通常是字体名称变了或字体没有安装全可以用系统自带的字体管理器确认。也有人在编译时遇到“LaTeX Error: Filefontspec.sty not found”这种提示这多半是方案选择时没装全或者 tlmgr 更新失败。最简单的方法是重新执行tlmgr install fontspec ctex如果还不行就考虑是不是full scheme 之外的精简方案漏了太多依赖。6. 安装与使用中的常见问题速查最后这部分把实际遇到的高频问题整理成速查表基本都是群里每天有人反复问的那几个直接照着排查就行。6.1 安装被 SmartScreen 拦截或双击无反应对策右键安装脚本选“以管理员身份运行”如果还有红色/蓝色警告点“更多信息 - 仍要运行”。如果双击install-tl-windows.bat没有任何反应检查路径是否包含中文字符或空格换个目录重新解压再试。另一种情况是系统里缺 Visual C 运行库xelatex 等程序依赖它去微软下载最新的 VC 运行库安装即可。6.2 安装进度条长时间不动先打开任务管理器看磁盘占用如果安装进程还在读盘或写盘就继续等。如果确认已经失去响应超过半小时可以强制结束进程后重新启动安装器。因为网络安装器会在本地缓存已下载包重新运行会从断点继续不用全部重来。若仍然卡在下载阶段建议换成国内镜像源重新执行。6.3 终端提示“tex 不是内部或外部命令”原因基本是 PATH 未生效或安装路径没加入环境变量。先重新开一个终端因为安装时写入的路径不会更新到已打开的窗口。还不行就手动添加C:\texlive\2026\bin\windows。注意要同时添加C:\texlive\2026\bin\windows不是C:\texlive\bin\windows很多人在这里多写少写一层目录。6.4 多个 TeX Live 版本混用导致版本不一致如果你的 PATH 里既有 2025 又有 2026命令行里使用的版本取决于 PATH 中显示的先后顺序。想要彻底只留 2026就按第 1 节的方法完整卸载旧版本。暂时不想删旧版也可以把 2026 路径调整到旧版路径之前但这只是临时方案长期用还是建议清理。6.5 编译中文模板时报错或乱码先说结论用 XeLaTeX 编译并保证文档文件编码是 UTF-8。如果你看到 PDF 里中文变成空白或方块说明该字体在当前引擎下不可用可以用\setCJKmainfont{SimSun}明确指定字体。如果报错信息是“Sorry, but xelatex.exe did not succeed”打开.log文件拉到最后真正的错误原因往往在最后 10 行不要被前几百行 Warning 吓到。我在实际使用中还发现一个很容易忽略的细节Windows 自带的输入法会在源文件里插入“全角空格”或特殊标点而 LaTeX 对这类字符的处理有时不报错只是编译结果样式不对。所以排版如果突然出现奇怪的间距先检查源文件里是不是混进了全角空格再考虑宏包问题。说到底TeX Live 2026 的安装并不复杂复杂的是各种环境细节。只要安装前清理好旧版本、安装时选对方案和镜像、安装后耐心更新一次宏包接下来的使用体验就会稳定很多。以上这些坑是我这几年在 Windows 上换版本时反复踩过的整理出来也算给自己留个备忘希望你能一次装成别再被安装流程劝退。