MiKTeX 套件下載失敗：檢查倉庫、自動安裝及用戶模式

MiKTeX 套件下載失敗時，先確認缺少的套件及編輯器真正使用的安裝。核對用戶或管理員模式、自動安裝和來源倉庫後才比較連接；套件識別與文件編譯分開驗證。

關鍵要點：

• 缺檔、自動安裝被停用及倉庫逾時是不同故障。
• 保留套件、倉庫、安裝目錄及模式。
• 管理員模式維護共享安裝，不是網絡修復。
• 套件取得成功後，文件仍可能有 TeX 錯誤。

步驟 1：MiKTeX 套件下載失敗時先核對哪個安裝？

儲存文件，閱讀首個編譯器或安裝程式具體錯誤。記下缺少檔案、建議套件、引擎、編輯器、安裝位置及原操作。最後建立失敗摘要不證明曾發出套件下載。

MiKTeX 可按配置自動安裝缺少套件；官方手冊將安裝、套件管理和使用套件的 TeX 處理分開。先確認安裝程式有否啟動。［1］

.sty、字型等可屬發行套件，也可屬項目自有檔案。先用可信套件目錄及項目說明確認歸屬，不因名稱相同便從陌生網站取檔放進安裝。

核對編輯器選用的 TeX 執行程式。多套 MiKTeX 或另一發行版並存時，Console 改動可以對編輯器無效。將引擎路徑與要維護的 Console 安裝比較。

保留原始碼、參考文獻、資源、引擎及輸出位置。編譯可執行項目定義的操作，只使用可信文件和既有安全選項，不為觸發下載而開 shell escape 或執行陌生模板。

如多個應用同時故障，先用裝置與應用程式排查框架，再回到套件及安裝。未確認安裝錯配前重裝編輯器，不能隔離原因。

步驟 2：用戶及管理員模式控制甚麼？

Console 通常以用戶模式管理私人配置。系統安裝可有要管理員模式維護的共享部分；官方解釋選擇，應配合實際安裝，不是選權限較高的一項。［2］

觀察	保留證據	正確處理
沒有下載開始	自動安裝選擇及原錯	核對停用或等批准
套件只在另一模式可見	私人／共享安裝及狀態	配對 Console 模式
倉庫請求逾時	來源身份及傳輸錯誤	連接與獲准代理
下載後寫入失敗	安裝目錄及檔案系統錯誤	找負責人處理權限或磁碟
套件已裝仍缺檔	引擎路徑及套件身份	核實使用同一安裝
找到套件後 TeX 出錯	首個新編譯錯誤	獨立處理文件

提升權限的 Console 可合法維護共享安裝，但不等於權限修好網絡。比較時固定模式及目錄，另記任何管理維護決定。

核對另一用戶或維護工作是否正在操作共享安裝，先協調，不啟動並行套件操作。資料庫鎖或安裝佔用是本機條件，不證明倉庫主機不可達。

目標為用戶安裝時，不轉管理員模式將套件安裝到另一位置；原編輯器可繼續用私人樹，缺資源依然存在。布局不清先問安裝負責人，不刪檔或任意改根目錄。

步驟 3：如何核對 MiKTeX 自動套件安裝？

開對應安裝的 Console，選 Settings 的 General。官方列出 Ask me、Always install missing packages on-the-fly、Never install missing packages on-the-fly，改動前記下原選項。［2］

安裝被停用時，換連接不會產生自動請求。若有權加入已確認套件，可保留政策指定選項，用 Console 明確安裝該套件，不對所有文件全面啟用自動安裝。

Ask me 時檢查是否等待對話框，提示可能被其它視窗遮住。只批准身份及來源已核實的套件，不把未回答的提示視為傳輸停滯。

從官方支援的選擇採用倉庫，記錄實際來源。它可以本機或遠端，本機路徑缺套件需要本機維護而非公網比較。套件工具支援明確倉庫，參數及行為要核對已安裝版本。［3］

機構要求來源或代理時保留，不換隨意封存檔網站、不從論壇私訊取得套件。獲准換源可另作修復，同時換來源和路徑便不再測原倉庫。

本地閱讀代理配置，Windows 代理指南可解釋周邊環境，但 Console 未必用瀏覽器相同設定。截圖排除憑據，保留 TLS 與完整性檢查。

步驟 4：如何比較同一 MiKTeX 倉庫連接？

在 Console 套件管理畫面找已核實缺少套件，保留模式及倉庫再次安裝。固定目的地與文件輸入，區分元資料、封存檔傳輸、解壓及安裝階段。

官方 miktex packages 分別處理資料庫維護和套件安裝，不將所有維護命令當通用修復，只用目前版本及觀察所需的操作。［3］

瀏覽器成功下載另一檔案並不足夠。瀏覽器下載檢查可辨認一般本機故障，MiKTeX 仍須經指定來源取得套件，放入預期安裝。

身份、設定及寫入權限正確，遠端倉庫仍反覆逾時時，可在執行 Console 的電腦連接 AethoVPN：Windows 用官網安裝程式，Debian/Ubuntu x64 用 .deb，選目前可用的就近位置、開全局模式，再安裝同一套件。Mac 須 Pro 或 Premium，按官網指引在 VPN 客戶端連接；Standard 不適用桌面。

維持用戶／管理員模式及倉庫，確認 Console 傳輸和安裝。替代連接不啟用停用的安裝程式、不提供管理權限、不修錯配 TeX 樹，也不改文件語法。相同錯誤或情況更差便回到原連接並停止。準備獲准倉庫比較時，可以電郵建立帳戶。

按連接比較清單分開路徑結果及套件接受；如有需要，檢查目前公網 IP，新地址不證明封存檔已下載或編輯器找到檔案。

已有封存檔或元資料可讓操作成功而無新請求，不能稱為新倉庫傳輸。保留這項限制，不為強迫下載刪除正常套件。

步驟 5：如何確認缺少套件階段恢復？

確認 Console 在預期用戶或共享安裝識別套件已安裝，再用原編輯器及引擎編譯同一可信文件。先確認原缺資源訊息消失，才解讀之後的 TeX 錯誤。

Console 成功但編輯器仍找不到時，重新比較安裝及引擎路徑，核對檔案屬該套件還是同類副檔名的項目資源。完整文件未成功不等於網絡失敗。

官方說明在用戶管理 TEXMF 目錄手動安裝檔案後，要更新檔案名稱資料庫。這是本機發現操作，不是下載器，也不通用修復倉庫故障；只有目錄及手動安裝符合條件才使用。［2］

分清取得、套件註冊、檔案發現及 TeX 處理。套件已找到但仍有未定義命令、參考文獻、缺本機圖片或套件用法不兼容時，要維護文件，不再換連接。

持續故障記錄 MiKTeX 版本、系統、編輯器及引擎、模式、套件身份、倉庫用途、階段和首個具體錯誤，說明新傳輸或快取。排除用戶名稱、密碼、私人倉庫路徑及保密文件內容。

完整性錯誤、陌生來源或安裝歸屬不清便停止。共享權限或鎖找管理員，傳輸找倉庫負責人，識別後錯誤找文件維護者。不重設安裝或使用危險編譯選項製造成功。

總結

• 找出缺少套件及編輯器實際安裝。
• 核對自動安裝和模式歸屬。
• 分清本機原因後才比較同倉庫。
• 確認套件識別，再獨立查編譯。

常見問題

所有缺少 TeX 檔案都有可下載套件嗎？

不是。有些屬項目或手動管理目錄，先按可信套件及項目資訊確認歸屬，不只憑同名便安裝。

逾時便以管理員執行 Console 嗎？

管理員模式維護共享安裝且須獲授權，不是網絡修復；保留正確模式，將倉庫請求另外診斷。［2］

為何自動安裝沒有啟動？

配置可禁止安裝，亦可能等批准提示。核對官方選項，政策許可時明確安裝已確認套件，不先換路徑。

可同時換倉庫及啟用 VPN 嗎？

這會改來源及路徑，不能隔離原因。獲准來源修復另記，再以同套件同倉庫比較連接。

Console 裝好後為何仍缺檔？

編輯器可能使用另一安裝，或缺檔根本不屬該套件；先對照引擎路徑、模式和檔案身份，再重試網絡。

更新檔案名稱資料庫會重新下載嗎？

不會。它更新相關樹的本機檔案發現，包括官方手動安裝場景，不取得缺少封存檔或恢復倉庫連接。［2］

缺套件訊息消失但編譯仍失敗怎麼辦？

記錄套件階段恢復，查第一個新 TeX 錯誤；下載成功不保證文件語法、參考文獻、本機資源及套件用法正確。

封面採用 MiKTeX 經典文字標誌，來源標註 PD-textlogo，圖形未改動。

來源

1. MiKTeX Manual — https://docs.miktex.org/manual/
2. Manage your TeX installation with MiKTeX Console — https://miktex.org/howto/miktex-console
3. miktex packages — https://docs.miktex.org/manual/miktex-packages.html

Sources checked 2026 年 10 月 7 日。

---

延伸閱讀

• 檢查相關工具的下載階段
• 取得 MiKTeX 套件時再測 VPN
• MiKTeX Console 可能讀取的 Windows 代理