如果你在 Windows 上安裝 TeX Live 時撞見xz: (stdin): Compressed data is corrupt緊接著又蹦出一句TLPDB::_install_package: untar failed恭喜你踩到了這套發(fā)行版在 Windows 上最經(jīng)典的下載損壞問題。我第一次遇到這組報錯時以為是自己下載的安裝包壞了二話不說刪掉重下結(jié)果第二遍、第三遍還是同樣的戲碼整個人差點懷疑電腦硬件出了問題。后來才明白這兩個錯誤根本不是“安裝器”壞了而是下載環(huán)節(jié)的數(shù)據(jù)出了問題。這篇內(nèi)容就把這組報錯從原理到操作徹底拆開講清楚給你一條從哈希校驗、換源、清理殘留、離線安裝到后續(xù)維護的完整解決路徑。剛接觸 LaTeX 生態(tài)的新手、或者經(jīng)常被大體積軟件安裝包坑過的開發(fā)者都可以直接照著做。1. 先把報錯看透這兩個提示到底在說什么1.1 錯誤信息拆解哪一行才是關(guān)鍵xz: (stdin): Compressed data is corrupt里有兩個關(guān)鍵信息。xz是一種壓縮工具TeX Live 的軟件包在分發(fā)時幾乎全部采用.tar.xz格式封裝安裝器逐個下載回來之后需要先經(jīng)過 xz 解壓再用 tar 解開內(nèi)部文件。而(stdin)指的是數(shù)據(jù)不是從一個磁盤文件讀取的而是從“標準輸入流”里管道傳進來的——也就是說安裝器并不是下載一個完整的壓縮包落盤再慢慢解壓而是邊下載邊把數(shù)據(jù)流直接喂給 xz 工具。TLPDB::_install_package: untar failed是緊接著出現(xiàn)的第二句。TLPDB 是 TeX Live 的包數(shù)據(jù)庫對象_install_package是安裝器內(nèi)部真正把一個軟件包寫入本地數(shù)據(jù)庫的方法。當(dāng) xz 那邊解壓失敗tar 拿不到完整文件結(jié)構(gòu)這個內(nèi)部方法就會拋出untar failed隨后整個安裝流程中斷。這兩句報錯連在一起出現(xiàn)說明問題鏈條很清晰拿到手的壓縮數(shù)據(jù)本身已經(jīng)損壞。網(wǎng)絡(luò)上很多教程會讓你去刪緩存、重置 tlpdb但如果問題根源是下載數(shù)據(jù)壞了這些操作都是治標不治本。要解決它得從源頭重新審視下載環(huán)節(jié)。1.2 下載環(huán)節(jié)最脆弱為什么安裝器會碰上“壞包”TeX Live 在線安裝時安裝器會從你指定的倉庫地址請求數(shù)千個軟件包文件。每個包的大小從幾十 KB 到幾 MB 不等全部走 HTTP 或者 HTTPS 傳輸。Windows 上大多數(shù)安裝場景下這些請求會經(jīng)過本地的網(wǎng)絡(luò)協(xié)議棧、安全軟件掃描、甚至某些下載工具的透明接管只要任何一個環(huán)節(jié)把數(shù)據(jù)流改了幾個字節(jié)后面的解壓環(huán)節(jié)立刻炸掉。常見情況有三種。第一種是網(wǎng)絡(luò)連接不穩(wěn)定導(dǎo)致下載中斷但客戶端沒有及時感知到哭著把半個包當(dāng)成完整包去解壓。第二種是倉庫源本身的同步不完整——尤其是某些開源鏡像站在同步 TeX Live 倉庫的過程中如果你剛好趕上鏡像在更新某個包下載到的可能就是一份不完整的文件。第三種是安全軟件的實時防護在后臺掃描臨時目錄里的壓縮文件導(dǎo)致寫入異常或文件被隔離。Windows 下還有一個特別容易踩的坑是斷點續(xù)傳機制的表現(xiàn)不太穩(wěn)定。如果安裝器中途卡住你按了重試理論上它應(yīng)該從斷點續(xù)傳但個別情況下會從某個錯誤的位置繼續(xù)寫文件寫出來的就是一個邏輯損壞的壓縮包。這種包在 xz 解壓時不會有任何情面直接報Compressed data is corrupt。我之前幫一位朋友調(diào)試這個問題時他的現(xiàn)象特別典型每次報錯指向的包名都不太一樣一會兒是 A 宏包一會兒是 B 字體包。這說明不是倉庫里某個固定文件壞了而是整條網(wǎng)絡(luò)鏈路的穩(wěn)定性有問題。這種情況下反復(fù)重試同一個源幾乎不可能成功。1.3 判斷問題的三個信號遇到這組報錯先別急著重裝?；▋煞昼娮鋈碌谝淮_認報錯中提到的時間點。如果錯誤是在安裝進行到大約 60% 到 90% 之間突然出現(xiàn)的基本可以認定是網(wǎng)絡(luò)或傳輸層問題而不是 ISO 鏡像文件本身的問題。第二觀察報錯指名的包是否固定。如果每次都是同一個包包名說明該文件在鏡像上的數(shù)據(jù)本身有問題換一個倉庫源通常能解決。如果每次都不同大概率是你的網(wǎng)絡(luò)鏈路不夠穩(wěn)。第三查看安裝日志。TeX Live 安裝器在工作目錄下會保留install-tl.log里面有詳細的下載和解壓記錄能夠看到具體失敗在哪一步。日志比屏幕上的兩行報錯信息靠譜得多排查問題時優(yōu)先翻它。2. 動手解決第一步讓“下載源”徹底干凈2.1 先算哈希別信“下載完成”四個字我對安裝大型開源軟件的一個執(zhí)念是下載完必須做哈希校驗沒校驗之前絕不動手安裝。TeX Live 的完整安裝鏡像體積在 5GB 到 6GB 左右這個量級的文件單靠瀏覽器、下載工具那句“下載完成”判斷完整性是非常不靠譜的。正常網(wǎng)速下下載 5GB 文件往往要十幾分鐘到幾十分鐘這么長的傳輸時間里任何一段網(wǎng)絡(luò)波動或本地寫入異常都可能讓文件變成壞檔而工具本身并不會替你察覺。如果你用的是離線 ISO 鏡像安裝方案前往鏡像網(wǎng)站下載對應(yīng)版本的 ISO 文件時頁面一般會同時提供 SHA256 校驗值。在 Windows 的 PowerShell 里執(zhí)行Get-FileHash -Algorithm SHA256 .\texlive2025.iso計算出來的 64 位哈希字符串要和你看到的官方公布值完全一致。一個字符都不能差。如果算出來的結(jié)果和公布值對不上別猶豫刪掉重下。這個動作能過濾掉一大半后續(xù)安裝報錯。如果你下載的是安裝器install-tl.zip同樣可以算一次哈希。這個文件體積不大幾 MB 而已但一樣可能損壞。2.2 換源的正確姿勢圖形界面和命令行兩條路下載源選得對不對直接決定在線安裝能不能熬到最后。國內(nèi)網(wǎng)絡(luò)環(huán)境下訪問某些境外倉庫源速度慢、穩(wěn)定性差出問題的概率很高。更好的做法是選擇距離你近、同步頻率又比較高的開源鏡像站比如一些高校維護的鏡像站或者國內(nèi)頭部云廠商提供的開源鏡像倉庫。用圖形界面方式換源解壓安裝器后雙擊運行install-tl-advanced.bat在彈出的高級向?qū)Ы缑胬镎业絺}庫Repository設(shè)置項。安裝器會給一個默認地址你把它改成本文所示格式的鏡像地址即可。注意如果你是第一次使用建議先打開瀏覽器訪問這個鏡像地址確認目錄結(jié)構(gòu)里能看到tlnet和tlpkg這些子目錄再拿來當(dāng)倉庫源使用。用命令行方式換源install-tl-windows.bat --repository https://mirror.example.invalid/texlive/tlnet/這里要特別提醒不要從網(wǎng)上隨手復(fù)制別人貼出的鏡像地址。網(wǎng)上許多教程里的地址已經(jīng)過時指向的可能是早已停止同步的舊目錄。地址一定要自己上鏡像站頁面確認以頁面標注的實際路徑為準。2.3 順手排查殺毒軟件和系統(tǒng)安全策略Windows Defender 的實時防護和第三方殺毒軟件是 Windows 上安裝 TeX Live 的另一個隱形炸彈。安裝過程中安裝器會在臨時目錄、安裝目錄之間快速寫入大量小文件安全軟件的實時掃描機制一旦介入輕則拖慢速度重則把壓縮文件誤判為惡意軟件直接隔離。你看到的現(xiàn)象就是安裝到一半某個包解壓失敗然后報出一串莫名其妙的錯誤。排查思路很簡單在安裝期間臨時把 TeX Live 相關(guān)的安裝目錄加入殺毒軟件的排除名單或者暫時關(guān)閉實時防護。裝完之后再重新開啟并做一次全盤掃描。這不是讓你長期關(guān)閉防護只是在安裝這個特定大型軟件期間的臨時操作。另外如果你用了各種“下載工具”下載安裝包也要注意這些工具的多線程加速邏輯可能會反復(fù)改寫文件塊。下載完成后的哈希校驗就是用來發(fā)現(xiàn)這類問題的不要跳過。提示如果同一份 ISO 連續(xù)兩次哈希計算結(jié)果都不同優(yōu)先懷疑內(nèi)存故障或磁盤故障別繼續(xù)留在下載環(huán)節(jié)上死磕。3. 動手解決第二步清理殘留來一次干凈的重裝3.1 卸載和殘留清理的標準動作在線安裝失敗到一半你的系統(tǒng)里可能已經(jīng)殘留了半成品 TeX Live 目錄。很多人直接刪掉安裝目錄就重裝結(jié)果還是報錯就是因為殘留數(shù)據(jù)影響了新安裝器的工作。我建議的清理動作是這樣在“控制面板”的“卸載程序”里找到 TeX Live 卸載項執(zhí)行卸載。手動刪除C:\texlive整個目錄。如果你的安裝目錄不是默認路徑就去你當(dāng)時填寫的路徑里刪除。進入C:\Users\你的用戶名\AppData\Local\texlive和C:\Users\你的用戶名\AppData\Roaming\texlive把帶texlive字樣的目錄刪除。在系統(tǒng)環(huán)境變量 PATH 里檢查并刪除殘留的 TeX Live 路徑條目例如C:\texlive\2025\bin\windows。重啟電腦再開始新的安裝。第 4 步很容易被忽略。PATH 里殘留的路徑指針指向的目錄已經(jīng)不存在了雖然它本身不一定會引發(fā)壓縮數(shù)據(jù)損壞報錯但會讓安裝完成后的命令環(huán)境亂七八糟所以一并清掉最好。重啟之后建議不要立刻重試在線安裝而是切換到下一步要講的離線安裝方案。因為前面已經(jīng)證明了你當(dāng)前的網(wǎng)絡(luò)鏈路不夠穩(wěn)定再用同樣的方式賭一次只是把同樣的錯誤再體驗一遍。3.2 推薦“離線安裝”ISO 鏡像才是最穩(wěn)的方案在線安裝的問題在于“邊下邊裝”這個動作本身太脆弱。數(shù)千個小文件、數(shù)千次 HTTP 請求任何一個請求出問題都會讓整個安裝前功盡棄。離線安裝則完全不同先通過下載工具或瀏覽器從鏡像站把完整 ISO 文件拿到本地校驗哈希掛載或解壓后讓安裝器直接讀取本地文件徹底繞開網(wǎng)絡(luò)波動。操作步驟從鏡像站下載完整 ISO 安裝鏡像。校驗 SHA256 哈希確認無誤。雙擊 ISO 文件在資源管理器中掛載或者用解壓軟件解壓到一個純英文路徑比如C:\texlive-iso。以管理員身份運行安裝器install-tl-windows.bat。在高級設(shè)置里把倉庫指定為本地路徑例如C:\texlive-iso。這樣安裝時安裝器直接從本地磁盤讀取壓縮包再解壓速度完全取決于你的磁盤讀取速度遠比網(wǎng)絡(luò)傳輸穩(wěn)定。我實測下來一個完整的 TeX Live 安裝在本地源模式下通常十幾分鐘到半個小時就能完成而且?guī)缀醪粫俪霈F(xiàn)xz: (stdin): Compressed data is corrupt這種傳輸層報錯。離線安裝唯一的代價是下載時間較長但一次下載無限次使用對于以后要在多臺電腦上裝 TeX Live 的人這個成本非常劃算。3.3 安裝參數(shù)的取舍方案、目錄、環(huán)境變量新版 TeX Live 安裝器比較高階但我不建議新手全盤套用默認設(shè)置直接“全部安裝”。安裝方案scheme里scheme-full會拉下大量宏包和字體文件體積膨脹得非常厲害。對大部分科研寫作者來說scheme-basic或者scheme-small已經(jīng)足夠日常編譯使用缺的宏包后續(xù)可以用tlmgr install 宏包名按需補充。安裝目錄方面Windows 下默認路徑一般是C:\texlive\2025這個路徑本身沒有中文和空格可以放心使用。如果你非要改到別的盤也要保證路徑純英文且沒有空格否則后續(xù)某些工具處理路徑時會出奇奇怪怪的問題。環(huán)境變量設(shè)置方面安裝向?qū)е杏幸粋€path選項勾選后安裝器會自動把 TeX Live 的 bin 目錄寫進系統(tǒng) PATH。建議勾選省得裝完之后手動配。如果忘了勾選也沒關(guān)系后面用 tlmgr 重新配置或者手動添加環(huán)境變量都可以。4. 進階操作配合官方倉庫鏡像的安裝配置4.1 鏡像站安裝器的兩種用法很多開源鏡像站在提供 TeX Live 鏡像時會同時提供兩種資源一種是體積較小的install-tl.zip安裝引導(dǎo)器另一種就是完整 ISO。它們的用途不一樣。install-tl.zip體積只有幾 MB下載速度快。它的工作方式是安裝器本身從你指定的倉庫地址在線拉取宏包安裝過程中會動態(tài)請求網(wǎng)絡(luò)數(shù)據(jù)。當(dāng)你網(wǎng)絡(luò)質(zhì)量不佳時我前面提到的一大堆問題就都會冒出來。所以這個安裝器更適合網(wǎng)絡(luò)環(huán)境穩(wěn)定、或已經(jīng)確定了一個可用倉庫源的情況。完整 ISO 則適合網(wǎng)絡(luò)狀況不太理想、或者想一次下載反復(fù)使用的場景。如果你人在局域網(wǎng)環(huán)境、公共 WiFi 或者校園網(wǎng)里我會直接建議放棄在線安裝路徑直接抓 ISO 走本地源。正確用法是先在鏡像站頁面看清楚目錄結(jié)構(gòu)找到install-tl.zip或install-tl-windows.zip的下載鏈接下完解壓再運行里面的批處理文件。鏡像站頁面上的目錄結(jié)構(gòu)通常是一目了然的只要你能看到tlnet目錄就說明該鏡像在同步中。4.2 用配置文件實現(xiàn)“無人值守”安裝如果你需要在多臺電腦上裝 TeX Live或者不想在圖形界面里手動點一堆選項可以準備一個texlive.profile配置文件讓安裝器讀取這個文件完成自動安裝。一個參考配置如下selected_scheme scheme-basic TEXDIR C:\texlive\2025 TEXMFLOCAL C:\texlive\texmf-local TEXMFSYSCONFIG C:\texlive\2025\texmf-config TEXMFSYSVAR C:\texlive\2025\texmf-var TEXMFSYSCACHE C:\texlive\2025\texmf-var TEXMFHOME C:\Users\yourname\texmf option_doc no option_src no option_fmt 1 option_letter 1 option_path 1 option_desktop_integration 1 option_file_assocs 1 option_tlpdb 0保存為texlive.profile后在安裝器所在目錄打開命令行執(zhí)行install-tl-windows.bat --profile texlive.profile安裝器會按照文件里的配置靜默安裝。option_doc no和option_src no比較關(guān)鍵它們會讓安裝器跳過文檔和源碼包能大幅縮減安裝體積和時間。如果你需要離線查手冊可以改成option_doc yes。有一點要提醒你配置文件里的路徑如果帶有中文或者空格容易出問題所以盡量保持純英文的絕對路徑。這個配置 I 試過在幾臺機器上重復(fù)使用效果很穩(wěn)。4.3 安裝完成后的第一件事更新包管理器安裝成功之后第一件事不是急著寫論文而是把 tlmgr 的倉庫源也指到國內(nèi)鏡像站對應(yīng)的 tlnet 地址然后做一次自更新。tlmgr option repository https://mirror.example.invalid/texlive/tlnet/ tlmgr update --selftlmgr是 TeX Live 的包管理工具你之后裝任何宏包都要靠它。如果不先把倉庫源切到穩(wěn)定鏡像你之后運行tlmgr install 某個宏包時又會出現(xiàn)和安裝時一模一樣的下載損壞問題。先更新 tlmgr 自身再按需安裝宏包這樣能避免一次拉取大量數(shù)據(jù)導(dǎo)致新的網(wǎng)絡(luò)風(fēng)險。日常使用中當(dāng)你需要某個宏包但編譯報錯提示找不到時用tlmgr install 宏包名單獨安裝就好完全不需要去重裝整個 TeX Live。5. 常見問題與排查技巧實錄5.1 錯誤變體對照速查表我整理了一張速查表涵蓋了安裝和后續(xù)使用中可能碰到的同類報錯方便你直接對照排查。報錯片段直接原因優(yōu)先解法xz: (stdin): Compressed data is corrupt下載的壓縮數(shù)據(jù)損壞校驗哈希、換源或改用離線 ISOTLPDB::_install_package: untar failed安裝器無法解開損壞的包同上清理殘留后重裝checksum mismatch下載過程中數(shù)據(jù)被改寫或鏡像同步異常重下、換鏡像源、關(guān)閉安全軟件后重試could not load tlpdb倉庫地址無法訪問或目錄結(jié)構(gòu)不符打開瀏覽器確認鏡像地址有效invalid or corrupted package具體某個宏包的文件損壞先看是否固定包名是則換源No such file or directory路徑包含中文或空格安裝目錄全部改用純英文路徑安裝卡在 99% 不動最后一個宏包下載緩慢或網(wǎng)絡(luò)中斷等待或 CtrlC 后用本地源重試這張表里的報錯絕大多數(shù)歸根結(jié)底都是同一件事數(shù)據(jù)流在傳輸過程中出了問題。所以排查的時候不要被花式報錯帶偏回到“數(shù)據(jù)完整性”這個原點去解決。5.2 三次典型的踩坑復(fù)盤第一次踩坑是我自己下載 ISO 時偷懶用了一個下載工具去拉文件。工具顯示下載完成我連哈希都沒算就開始安裝結(jié)果解壓到一半直接報xz: (stdin): Compressed data is corrupt。重下太浪費時間我就想著“跳過這個壞包繼續(xù)裝”結(jié)果越裝越亂最后只能全部刪干凈重來。從那以后ISO 下載完沒算哈希之前我絕不會雙擊任何安裝文件。第二次是幫一個朋友排查他在宿舍的網(wǎng)絡(luò)環(huán)境里反復(fù)在線安裝每次報錯包名都不固定。我建議他改成國內(nèi)鏡像站他換了幾個源還是報錯最后發(fā)現(xiàn)是電腦上裝的安全軟件把安裝器臨時目錄里的壓縮包當(dāng)成了威脅對象動不動就隔離文件。關(guān)閉實時防護后同一個源一次就裝完了。第三次是一臺安裝目錄路徑里帶了中文符號的機器安裝過程經(jīng)常在某個位置報No such file or directory和壓縮損壞報錯混在一起非常迷惑。后來把路徑全部改成純英文目錄所有問題消失。Windows 下很多開源軟件的路徑兼容性就是這么敏感別跟版本較勁。5.3 驗證安裝環(huán)境的小測試確認 TeX Live 真的裝好了打開命令提示符或者 PowerShell依次執(zhí)行xelatex --version kpsewhich --version tlmgr --version三條命令都有正常輸出版本信息說明基礎(chǔ)環(huán)境沒有問題。接著做一個更實際的測試新建一個文件test.tex寫入一個最小文檔。\documentclass{article} \begin{document} Hello, TeX Live! \end{document}在命令行執(zhí)行xelatex test.tex如果編譯順利生成 PDF 文件整套環(huán)境基本就穩(wěn)了。之后如果某個文檔編譯時提示缺宏包用tlmgr install 宏包名單獨補裝不要再走一遍全量安裝。最后再分享一個我自己的習(xí)慣?，F(xiàn)在只要是體積超過 1GB 的安裝包我第一步永遠是先復(fù)制官方哈希值到記事本下載完成后用Get-FileHash算一遍確認無誤才動手安裝。這個習(xí)慣讓我近幾年幾乎沒有再被Compressed data is corrupt這類問題坑過。如果你在 Windows 上安裝 TeX Live 也遇到同樣的報錯別在一個不穩(wěn)定的在線源上反復(fù)重試直接把目標切換到離線 ISO 加鏡像倉庫的方案一次裝成的概率會高得多。