TeX Live 下載失敗時，轉換網絡前先確認正維護哪份安裝，以及發行年份是否與倉庫相符。兼容的官方鏡像仍逾時，才比較同一套件的另一條獲准路徑，再把套件管理結果與文件編譯分開驗證。

關鍵要點：

發行版管理的 TeX 與上游 TeX Live 採用不同維護途徑。

倉庫年份不相符並非下載速度問題。

記錄真正選中的鏡像，CTAN 自動選擇可在兩次之間改變。

保留驗證，區分套件傳送、安裝後處理及編譯錯誤。

TeX Live 下載失敗反映哪項操作？

TeX Live 安裝器下載所選安裝內容，tlmgr 則管理已有安裝的套件，官方指南與管理器文件分開說明兩項職責。［1］［2］倉庫中繼資料、壓縮檔傳送及本機設定失敗，需要不同證據。電腦有更廣泛連接問題時，先依設備與應用排查次序檢查。

辨認失敗階段

保留最早錯誤與產生它的命令，記錄來自 install-tl、tlmgr、發行版套件管理器，還是編輯器啟動的另一工具。不應把所有提到「package」的訊息都當作要重跑網絡安裝器。

觀察結果	分支	下一項證據
本機與遠端發行年份不同	倉庫相容性	實際 TeX Live 年份及倉庫身份
倉庫資料庫未能載入	倉庫連接	選中鏡像及首個請求錯誤
同一壓縮檔反覆逾時	套件分發	套件名稱、倉庫、傳送失敗
下載資料遭驗證拒絕	來源或完整性	保留驗證訊息，不略過
下載完成但設定或編譯失敗	本機工具或文件	安裝日誌與獨立編譯輸出

未弄清原因，不刪除部分安裝目錄，它可能已有可用套件或本機自訂檔案。保存日誌，才能把之後成功與原來操作對應。

步驟 1：安裝由誰管理，目前使用哪個版本？

分辨 TeX 來自系統套件管理器、上游 TUG 安裝器，還是獨立管理的平台發行版。採用該安裝負責人的維護方式，不因兩個工具都提及 TeX Live，就對同一目錄混用系統修復與上游更新。

核對真正執行的檔案

查看 TeX 與 tlmgr 執行路徑，記錄版本輸出。電腦可有多個年度安裝或編輯器專用環境，終端機和編輯器可能選不同檔案。比較前記下差異，編輯器顯示的版本未必是另一個終端機使用的版本。

上游安裝可用下列命令讀取管理器與倉庫選擇：

tlmgr --version
tlmgr option repository

由預定環境執行，不隨意加管理員權限；命令不會安裝套件。tlmgr 不存在、或發行版回報管理／user-mode 邊界時，跟從該發行版指引，不為測連接而新建另一份安裝。

保存非預設設定、本機字型或套件，以及可取得的原安裝 profile。個人文件不屬於安裝修復範圍。重新安裝是後續選擇，並非診斷一個逾時壓縮檔的方式。

步驟 2：tlmgr 倉庫連接失敗是否涉及發行年份？

查看本機 TeX Live 年份和工具回報的倉庫資料。不能只把舊安裝指向目前倉庫，就當作當年版本；出現年份差異時，依官方支援的升級或歷史倉庫流程處理。［2］

相容性處理好才比較傳送

輸出明確指出本機與遠端年份不同，就停止換路，選正確維護程序。保留該差異而反覆轉鏡像，可能只是存取同一不相容版本。不要未核對工具版本，就採用舊論壇的變通命令。

歷史安裝可需要相應凍結倉庫，新上游安裝則使用目標發行版的安裝器和倉庫；官方來源與年份一併核對。機構管理的安裝，由負責人決定允許版本和升級時間，不覆寫共用設定。

工具與倉庫符合官方支援的版本關係後，本分支才完成，並不需要 VPN 測試。保存原不匹配訊息，不在之後稱它為網絡逾時，或說較快路徑修復了年份差異。

步驟 3：CTAN 鏡像逾時來自哪個主機？

安裝器一般自動挑選 CTAN 鏡像，並在該次下載使用選中來源；repository 選項可指定來源。［3］記錄實際安裝輸出所列鏡像，而非只留最初的通用選擇器 URL。

分開選鏡像與選路徑

從官方 CTAN／TUG 來源核對兼容 HTTPS 鏡像，記下倉庫路徑。某鏡像內容陳舊或持續失敗時，選另一個官方兼容鏡像是來源比較。先完成這項比較，再做網絡換路，才知道改了哪個變數。

受控重試盡量固定實際鏡像與目標套件。自動選到另一鏡像時，把差異記下。兩次用同一通用選擇器，也未必向同一主機請求。

瀏覽器下載可幫助判斷廣泛故障，但它可能使用另一代理或快取物件。有需要可看瀏覽器下載故障定位，這裏仍以套件管理器請求為準。

記錄系統或機構代理，不公開密碼。Windows 可依代理檢查方法分辨原設定和 TeX 工具傳送。必要私人鏡像或機構代理維持獲准網絡，消費 VPN 不提供其基礎設施入口。

步驟 4：同一兼容套件可否換路下載？

發行年份和可信鏡像已確定，而失敗是逾時或傳送中斷時，才做這項比較。保存套件名稱、發行版本、倉庫主機、命令和首個錯誤。維持同一 scheme／套件選擇、目標目錄及權限。

鏡像不變，只改網絡路徑

若失敗的 install-tl 或 tlmgr 在 Windows 電腦執行，可用 AethoVPN 官方 Windows 安裝檔，連至同一兼容 HTTPS 鏡像作路徑比較。使用桌面檔位 Pro 或 Premium，在應用內選任務獲准的本國或鄰近位置，並開啟全局模式。重試原套件操作，分開比較倉庫資料庫與壓縮檔傳送，不只看 CTAN 網站能否開啟。

換路不會協調發行年份、還原缺少套件、給予寫入權限，或令 LaTeX 原始碼必定編譯成功。已有 VPN 後才出問題，先斷開取得獲准直連基線；另一條路徑較差則返回基線。快取重試較快或一個套件完成，都不是整體加速的證據。

鏡像分發仍是失敗階段時，可建立帳戶開始每用戶一次的 3 天 Pro 免費試用，比較同一套件。

示例使用 Windows，讓產品安裝明確，不假定所有 TeX 平台均有同一客戶端。依TeX 下載前的連接核對記錄條件，仍以原 TeX 工具結果驗收。不要同時換鏡像和 VPN 位置，再將成功歸因其中一項。

保留證書及倉庫驗證。官方管理器解釋密碼學驗證與適用條件，不能假定每個環境自動核對所有簽名，也不應停用已有檢查繞過錯誤。［2］驗證工具缺少或資料遭拒，先依官方指引調查，不繼續接受不可信內容。

步驟 5：套件管理已完成，還剩甚麼？

閱讀完整最後輸出和日誌。壓縮檔傳送後仍可有解壓、format 生成、路徑設定及其他本機錯誤。安裝器說明包含警告與日誌，應核對實際最後結果，不把最後下載當作整體完成。［3］

先驗套件再測文件

已有上游安裝可用 tlmgr info PACKAGE 查目標套件，把名稱換成實際值，確認記錄的安裝狀態。再看終端機是否選中預定發行版。另一份安裝的管理器成功，不等於本次目標已更新。

再以非關鍵小文件單獨測對應引擎和套件，編譯結果與下載恢復分開。缺字型、引擎錯誤、本機巨集衝突或文件語法問題，不會因壓縮檔下載而消失。

傳送仍失敗時，向支援提供工具路徑／版本、安裝管理者、年份、兼容鏡像、套件名稱、首個錯誤和直連／另一條路徑結果。移除 token、私人倉庫地址、用戶名稱及個人路徑。年份不符、反覆完整性拒絕、空間不足或權限錯誤，停止網絡實驗，由相關負責人處理。

部分恢復時，明確說明哪些已完成、哪些未完成。例如倉庫中繼資料和套件已成功，但安裝後操作仍失敗。這樣能保留進展，避免重新下載整套卻未處理剩餘原因。

總結

更新前確認管理歸屬及實際執行檔。
先處理年份相容，再記錄真正官方鏡像。
固定一個鏡像和套件，只更改網絡路徑。
分開驗收傳送、驗證、套件狀態與編譯。

常見問題

瀏覽器開到 CTAN，為何 tlmgr 仍失敗？

工具可以經另一代理請求不同鏡像、資料庫或壓縮檔。保存實際請求和選中主機，不能用瀏覽器存取代替套件管理器傳送結果。

換網絡會修復本機與遠端年份不符嗎？

版本相容性須先按支援維護途徑解決。另一條路徑仍可能取得同一不相容倉庫，不會把舊安裝變成預定新版本。

發行版管理的安裝應用上游 tlmgr 嗎？

採用安裝管理者的維護程序，不對同一目錄混用管理器。先辨認實際執行檔和套件歸屬，否則成功命令可更新編輯器不用的另一安裝。

CTAN 自動選擇器一直指向同一鏡像嗎？

自動選擇可以在兩次之間轉來源。記錄實際鏡像並在換路時固定，避免把倉庫變更當成路徑改善。

一個套件失敗可以停用驗證嗎？

保留原證書及倉庫檢查，調查可信鏡像、驗證工具與被拒資料。接受未驗證內容是不同安全結果，不是可信下載恢復。

套件下載成功是否代表文件能編譯？

編譯還依賴實際引擎、已安裝套件、字型與原始碼。先驗套件狀態，再單獨編譯非關鍵文件，按本機原因處理剩餘錯誤。

求助安裝問題要保留甚麼？

保留工具路徑／版本、發行年份、管理歸屬、鏡像、套件、首個錯誤和兩條路徑結果。提交去除敏感資料的日誌，分開傳送完成與設定警告，不傳私人地址或無差別重試全部。

來源

TeX Users Group — The TeX Live Guide — https://tug.org/texlive/doc/texlive-en/texlive-en.html
TeX Users Group — tlmgr: the native TeX Live Manager — https://tug.org/texlive/doc/tlmgr.html
TeX Users Group — install-tl: TeX Live cross-platform installer — https://tug.org/texlive/doc/install-tl.html

Sources checked 2026 年 10 月 7 日。

TeX Live 下載失敗：如何核對 CTAN 鏡像與倉庫版本？