無法編譯的大學類別檔

排查順序:第一個錯誤、引擎、過時套件、二分搜尋。

無法編譯的大學類別檔

大學論文範本是一種特別的遺留程式碼。十五年前某位研究生依照當時的 TeX 發行版寫了類別檔,畢業後就把它凍結在原地,而 LaTeX 生態系持續演進。今天你下載 universitythesis.cls,它死在一整片錯誤底下,通常不是類別壞了,而是被時間困住了。不過失敗模式是可以預測的,固定的排查順序就能解決大部分問題。

只處理第一個錯誤

LaTeX 的失敗會連鎖:類別檔前段的一個未定義命令,可以衍生出數十個毫無意義的下游錯誤。把記錄檔捲到第一行以 ! 開頭的地方,修好它,先重新編譯再看其他訊息。重複這個循環,通常三、四輪就能清掉一面嚇人的錯誤牆。如果第一個錯誤是未知命令,未定義的控制序列 會帶你走過診斷過程。

檢查引擎

許多範本假設特定的引擎,換成別的就會離奇失敗。載入 fontspec 或用名稱設定字型的類別需要 XeLaTeX 或 LuaLaTeX;依賴 pdftex 特定原語的類別則可能在兩者之下都失敗。找找類別檔開頭附近的註解,或大學說明中指出預期引擎的那一行,在除錯之前先讓環境符合它。差異整理在這個專案該用哪個引擎。

把你掌控的部分現代化

舊範本會載入過時的套件,而現代替代品早已在你的發行版裡,兩者接著就互相打架;互相衝突的套件列出了經典組合。可行的策略是不要動類別檔本身,因為大學的格式要求就寫在裡面,只把你自己的前言現代化:移除過時的 \usepackage 行,最後才載入 hyperref,並且不要重複載入類別已經載入的東西。

對前言做二分搜尋

當錯誤頑強得看不出所以然時,把前言的後半部註解掉再重新編譯。如果錯誤消失了,問題就在被註解的那一半;還原其中一半再重複。幾次編譯就能隔離出出錯的那一行,這比推理一份不是你寫的前言快得多。

先搜尋,別先受苦

那所大學的每個學生編譯的都是同一份類別,你的錯誤幾乎可以確定有人遇過。用確切的錯誤訊息加上類別檔名稱去搜尋,並確認大學或接手的學生是否在 GitHub 上維護修補過的 fork。如果有維護中的 fork,用它比自己重新修一堆已知錯誤划算。

返回 長篇文件