1. 两个报错到底在说什么：先搞清楚故障链路
先说结论：你看到的xz: (stdin): Compressed data is corrupt和TLPDB::_install_package: untar failed并不是两个独立问题，而是同一个根因在不同阶段的表现。
Windows 上安装 TeX Live 时，安装器（install-tl-windows.bat）本质上在做这样一件事：先下载texlive.tlpdb元数据文件，然后按清单逐个下载格式为.tar.xz的压缩包，再用 xz 解压、tar 解包，把文件释放到安装目录。整个过程和你在 Linux 上手动wget + tar -xf没有本质区别，只是被脚本封装了。
xz: (stdin): Compressed data is corrupt：下载下来的.tar.xz文件数据不完整，或者中途被截断，解压器读了一半就读不下去了。TLPDB::_install_package: untar failed：Perl 脚本在调用 tar 解包时拿到的是一个损坏的输入流，解包动作失败，于是安装流程被中断。
也就是说：下载环节出了问题，解压环节只是受害者。明白了这条链路，我们就知道不要盯着“解压失败”这四个字去折腾，而是该顺着数据源头排查。很多人在这一步犯了方向性错误，反复重装、反复报错，浪费时间。
| 报错信息 | 真实含义 | 故障环节 |
|---|---|---|
| Compressed data is corrupt | xz 解压器读到了非法/截断数据 | 文件下载不完整 |
| TLPDB::_install_package: untar failed | tar 解包动作执行失败 | 拿到损坏的包 |
| 安装进程中断并回滚 | 安装器无法继续 | 故障向上传导 |
2. 故障定位清单：按这个顺序排查，别一上来就重装
我的习惯是：遇到这类报错，先花十分钟快速锁因，再动手。因为 TeX Live 安装失败的重装成本很高，尤其当你选择 full scheme 全量安装时，要下载好几 GB 的文件，反复失败很打击积极性。
2.1 网络与下载源：八成问题都出在这
国内网络访问 TeX Live 官方主站（CTAN 主站或后端分发节点）时，经常出现连接不稳定、传输被重置、代理拦截等情况。安装器用的是 HTTP 下载，没有断点校验或完整性重试机制，一旦中途断流或者被网关注入干扰包，保存下来的文件就是损坏的。
判断方法很简单：重新执行一次安装，看是不是在同一个包上报错。如果每次报错的包名都不一样，基本可以断定是网络传输质量造成的随机损坏；如果总是在同一个包上报错，那可能是本地缓存坏了，也可能是镜像源上这个包本身有问题。
2.2 安全软件和系统权限：Windows 特有的干扰源
Windows Defender 或其他第三方安全软件会实时扫描新落地的文件。当安装器一边下载一边解压写入大量文件时，安全软件的扫描进程可能会短暂锁定文件句柄，导致写入中断。更隐蔽的情况是：安全软件把安装器下载的临时文件隔离了一部分，安装器自己并不知道，继续拿缺失的文件去解压，自然失败。
权限问题同理。如果安装目录选在了需要管理员权限的路径（比如C:\Program Files\TeXLive），而当前终端又没有以管理员身份运行，解压写文件时就会出现异常退出。虽然报错信息不一定直接指向权限，但untar failed也可能是文件无法创建导致的。
2.3 缓存残留与磁盘状态：容易被忽略的两个坑
install-tl-windows.bat默认会把下载的临时文件放在%TEMP%目录下，同时 tlmgr 自身也有缓存目录。如果上一次安装失败后没有清理干净，下次安装时脚本可能误读了残留的损坏文件，导致同样的报错反复出现。这类问题在“重装”场景下特别高发。
磁盘状态包括两点：一是可用空间是否低于 TeX Live 全量安装所需的 8~10 GB，二是磁盘是否出现坏道或文件系统错误。空间不足时，xz 解压到一半会写入失败，表现出来也是corrupt或者untar failed，但很多人第一反应不会想到是空间问题。
2.4 建议的排查顺序
我建议按下面的顺序走，性价比最高：
- 检查磁盘剩余空间是否充足（至少 10 GB 以上判为安全）。
- 换一个稳定镜像源，重新安装（解决 80% 的问题）。
- 关闭安全软件实时防护，以管理员身份运行安装器。
- 清理所有 TeX Live 相关缓存和临时文件，再重试。
- 如果以上都不行，直接下载完整离线 ISO 挂载安装。
3. 实操解决方案：从换源到命令行安装，按强度递进
3.1 方案一：换国内镜像源重试（最推荐）
官方安装器允许通过--repository参数指定下载源，这是解决问题最直接、最有效的手段。国内可以用的 CTAN 镜像源很多，比如清华、中科大等高校镜像站，它们都有同步 TeX Live 的完整仓库。
具体操作如下：
- 前往 TeX Live 官网下载
install-tl-windows.exe（或install-tl.zip）。 - 解压后，在
install-tl-XXXXXXXX目录里按住 Shift 键，右键打开 PowerShell 或命令提示符。 - 先以管理员身份运行（这一步非常重要，可以避免权限问题）。
- 执行安装并指定镜像源：
install-tl-windows.bat --repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet如果你用的是 bat 脚本，命令格式相同。执行后会弹出正常的安装菜单界面（图形式 TUI），接下来的安装流程和默认方式完全一致。
为什么换源能解决问题？因为安装器下载数据包时没有做端到端的完整性校验，它信任 HTTP 连接本身。但国内直连国际网络时，经过跨境链路容易出现分包丢失、连接重置。镜像站在国内，走的是国内的骨干网络，延迟低、丢包率小，下载的包能完完整整落盘。这其实是规避问题，而不是修复下载逻辑。
3.2 方案二：清理 tlmgr 缓存后再次安装
如果你已经指定了镜像源，却还在同一个报错上打转，那你要考虑是缓存残留导致的“旧货污染”。TeX Live 安装器和 tlmgr 会在几个位置存放临时文件：
%TEMP%下的install-tl*临时目录C:\Users\你的用户名\AppData\Local\texlive\下的 tlmgr 缓存- 安装器解压目录里可能残留的
.tar.xz文件
建议清理路径如下：
del /s /q %TEMP%\install-tl* del /s /q "%TEMP%\tl-*" rmdir /s /q "C:\Users\你的用户名\AppData\Local\texlive\2\tlpkg"清理的时候注意，如果某个目录正在被别的进程占用，删除会失败。可以先关掉所有与 TeX Live 相关的进程，再执行清理。
清理完以后，重新执行安装命令。如果这次能顺利越过之前报错的那一步，说明确实是残留缓存损坏文件导致的。这种情况在“第一次安装失败后重试”时非常常见，因为 tlmgr 不会主动清理自己下载了一半的文件。
3.3 方案三：使用本地 ISO 或已完整下载的离线包安装
网络环境实在太差，换镜像源也救不了的时候，还有一个稳妥的兜底方案：下载完整离线 ISO 镜像，然后挂载或解压后本地安装。
TeX Live 每年的发布版本都提供 ISO 镜像，大小在 4~6 GB 左右。这个 ISO 里包含了全套安装包，安装过程完全不依赖网络。你只需要：
- 从镜像站下载
texlive.iso（文件名类似texlive-2025.iso或带日期格式）。 - 右键挂载 ISO（Windows 10/11 自带的挂载功能即可，也可以解压出来）。
- 进入挂载目录，在
install-tl-windows.bat所在的路径执行：
install-tl-windows.bat --repository .这里--repository .表示使用当前目录作为本地仓库。安装器会直接从挂载的 ISO 里读取和安装全部文件包，不会再进行任何网络下载。
这个方案的优点不止是绕开网络问题。ISO 里的文件是官方制作时校验过的，完整性有保障，Compressed data is corrupt这类报错几乎不可能出现在 ISO 安装里。如果你网络长期不稳，或者反复折腾已经失去了耐心，直接下载 ISO 是最省心的方法。
3.4 方案四：安装时关闭某些环节，降低失败面
如果你不需要完整安装，只是想先装一个能用的 TeX Live，可以在安装菜单里调整 scheme。安装器启动后会呈现一个文本菜单，其中S选项是切换安装方案：
- 输入
S，进入方案选择。 - 选择
scheme-small（基础小套装）或scheme-basic，体积只有几百 MB，下载时长大幅缩短，碰到网络中断的概率随之降低。 - 后续需要宏包时，再通过 tlmgr 按需安装。
这个思路和项目管理里的“先跑通最小闭环”一样。先把基础环境装好，验证安装流程没有问题，再去装全量宏包集合，避免在网速不稳的情况下让安装器去拉一个好几 GB 的大仓库。
4. 反复踩坑后的经验：关于 tlmgr 仓库配置和校验
把 TeX Live 装完不是终点。很多人在安装完成后不久，又会在tlmgr install某个宏包时碰到类似的Compressed data is corrupt报错。原因很简单：安装器用--repository指定的镜像源只在安装过程中生效，安装完成后 tlmgr 还在继续使用默认的官方源。
4.1 安装完成后务必重新指定 tlmgr 仓库
安装结束后，打开开始菜单里的 TeX Live 命令提示符（或者自己配置好环境变量），执行：
tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet这个命令会把 tlmgr 的默认下载源永久切换为国内镜像。下次安装宏包时，就不会走跨境网络了。
也可以直接写到配置文件里。配置文件位于C:\Users\你的用户名\AppData\Roaming\TeXLive\下，路径因版本而异，可以通过tlmgr option sys_bin查看相关配置。但一般情况下，用上面那条命令就够了。
4.2 如何确认安装完整且可用
安装完成后不要急着关终端，做三个简单验证：
- 检查版本号：
pdflatex --version正常输出会显示pdfTeX的版本号和编译日期。
- 编译一个最小文档：
\documentclass{article} \usepackage{ctex} \begin{document} Hello, TeX Live! \end{document}保存为test.tex，用pdflatex test.tex编译，生成的 PDF 能正常打开且包含中文内容，说明 ctex 宏包已经可用。
- 测试 tlmgr 能否正常拉取宏包列表：
tlmgr update --list这一步需要联网。如果这条命令不再报Compressed data is corrupt，说明 tlmgr 仓库配置已经生效。
4.3 终极兜底操作：调整安全软件白名单
如果你试过所有方法，且重点怀疑是安全软件拦截导致文件写入不全，可考虑把以下目录加入安全软件白名单：
- 安装目录（如
C:\texlive） %TEMP%目录C:\Users\你的用户名\AppData\Local\texlive
但这里必须提醒一点：安装完成后，建议将安装目录从白名单中移出，恢复安全软件的默认防护。白名单是一把双刃剑，用的时候要清楚地知道自己在做什么。毕竟安全软件吞噬文件句柄的情况虽然有，但远不如网络问题那么普遍，不要一遇到报错就归咎于安全软件。
4.4 一个容易被忽略的要点：安装目录选择
很多人的untar failed问题，最后发现是安装目录选的路径有毛病。比如目录路径中包含中文、空格、或过长的目录层级，某些版本的 tar 在 Windows 上处理带空格的长路径时会失败。
经验建议：安装目录直接选简单的英文路径，比如C:\texlive\2025。别放桌面、别放带空格的文件夹。这虽然不是万能解药，但能帮你避开一类非常隐蔽、报错信息又很模糊的坑。
最后说点实际操作中的体会
这几类报错我在日常帮人排查时见过太多回了，绝大多数案例最后都落在同一个点上：下载源不可靠。我自己第一次在 Windows 上装 TeX Live 时也踩过同样的坑，当时不懂--repository参数，反复重装了四五次，最后是偶然换了一个国内镜像源才装成功。装完以后 tlmgr 装宏包又报同样的错，才意识到安装时指定的源不会永久生效，得手动改仓库配置。
所以我强烈建议所有 Windows 用户，在拿到 install-tl 安装包的第一时间就带上--repository参数执行，别问为什么，直接照做就行。用完本地的 ISO 安装也一样，装完马上执行那条tlmgr option repository命令。这两件事能做对，安装过程基本就稳了。
还有一个容易被忽略的点：如果你的 Windows 系统时间不对（差好几年），安装器在校验签名或读取某些 meta 信息时也可能产生怪异行为。遇到难以解释的失败，顺手看一眼系统时间。
希望这篇文章能帮你少走几个小时的弯路。如果按上面的步骤操作后依然在同一处报错，试着换个时间段再下载，避开网络高峰期，或者干脆拉取 ISO 离线安装，这是最稳最省心的一条路。
