PS：原文圖裡面 TeX 後面漏了 {} 或者 <space>，而且引號寫反了……

輔助文件

讓我們來找個答辯模板編譯一個PPT吧，就從上一屆畢業生那裡拿一個好使的來好了。

曾經親眼目睹編譯成功的我，這次又栽在了起跑線上：

編譯之前刪掉原來的輔助文件，這是常識。把別人的東西拿過來直接跑基本不可能成功，這也是常識（誤）。

沒有問題創造問題也要上，不然怎麼點亮 github 的貢獻方格呢。

我們刷綠方塊都是靠改 typo 的（大誤）。

「握日，怎麼生出這麼多不認識的文件？？？比 Visual Studio 還多！文件夾都快填滿了！」

……通情達理的我知道每個文件背後，都有一個辛勤的開發者，花費無數個日日夜夜為這個格式的臨時文件設計語法、宏、變數、函數、數據格式……。每一個臨時文件都像一個祕密的寶藏等待著我去挖掘。我想到只要把這些中間文件都弄懂，我就是半個專家了。我已經迫不及待了，快讓我看看有多少種中間文件需要學習呀！彼之寶藏，我之垃圾。

輔助文件無非這麼幾類：

• 第一遍生成之後，第二遍再讀進去，以生成交叉引用、參考文獻、目錄、索引等（可能需要外部程序參與），比如 *.aux、*.bbl、*.toc、*.idx、*.ind 等
• 日誌，如 *.log、*.blg 等
• 目標文件的中間產物，如 *.dvi、*.xdv 等
• SyncTeX 相關，用於 PDF 與源文件之間的跳轉，如 *.synctex、*.synctex.gz 等

宏包那麼多，為了避免衝突，當然是生成不同的文件最簡單了。.gitignore 裡面寫的，一大半保證你不會遇到。反過來，遇到的 edge case 也未必能完全覆蓋，所以用之前最好自己 check 一下。

關於中間文件的語法，如果是被 TeX 讀進去的，那自然還是 TeX 的語法，並不會很詭異；日誌都是純文本，識字就能看懂。反正編譯中間沒必要管，編譯完了放心大膽地刪。編輯器一般都會有配套的工具，自己寫個腳本也應該沒什麼困難。

一些感悟

這是我使用 LaTeX 的第三年，踩了很多坑後，我也開始有了對 LaTeX 的一些感悟。

不巧，這也是我使用 LaTeX 的第三年（從我 2015 年年底裝 CTeX 套裝開始算，四年不到），所以我也有「對 LaTeX 的一些感悟」。

入門之前

在擁擠的辦公桌前，面對 doc 文件夾下三千多個 PDF readme，我知道我這輩子都沒辦法做一個 LaTeX 科班生。然而，命運不會等人，我手中小小的報告，常常 24h 內就必須要飛到老師的郵箱中。

比較不幸的是，大多數人用 LaTeX 都是被迫 / 半被迫的：你的老闆可能並不會管你會不會用就直接把你逼上梁山，建模比賽別人都用我不用就沒獎了（誤）。但沒有什麼辦法，24h 內掌握 LaTeX 就是不現實，至少得勻出幾個禮拜到幾個月的時間才能上手。既然知道「老闆可能要我用一個之前沒碰過的工具」，是不是應該提前預留一些學習時間呢？

我也希望自己能做一個弄明白 LaTeX 的人。然而可惜的是，我或許永遠無法將 LaTeX 看作一個「專業工具」，拿出鑽研編譯原理的勁兒來啃透 LaTeX。

這或許是因為，在座的你我需要的無非是排個章節、插個圖、上下標、來幾行公式……我們需要一個能好好地把字母排列到理想位置的「效率軟體」，而不是一個慢吞吞又挑三揀四難以融洽的「活祖宗」。

這是很多人的困擾：我就是隻要寫個文章為什麼要把 LaTeX 搞得這麼清楚？此時可以類比如下問題：

• 我只是寫個 C 的 Hello world，怎麼還要學命令行、學 Linux、學 Makefile、學 Git……？
• 我只是學計算機、學數學、學 xxx，為什麼要會英語？
• 我一個理科生為什麼要學語文？我一個文科生為什麼要學數學？買菜又不用三角函數微積分解析幾何……

具體問題具體來說。不管你認不認可，(La)TeX 就是一個完備的編程語言，雖然你需要的可能只是「作為標記語言」的那一個子集。所以，準備上手之前，請務必認清楚自己的身份：

1. 我要按照模版寫畢業論文、建模論文、期刊論文

你需要找一些合適的入門材料，學習基本的語法。有模版請嚴格按照模版的說明操作，不要根據自己的喜好做任何修改（你的感覺與偏好在這個階段極有可能是有問題的）。重點請放在文章的內容，而不是文章的格式。出現任何問題請找模版作者，沒有必要試圖自己解決。

2. 我要記筆記、出試卷、寫書

同上，請先從入門開始。熟悉基本流程之後再放飛自我，劉海洋的《LaTeX 入門》可以備在手邊隨時翻閱。每天讀兩次《入門》，每次都有新收穫。

3. 我要系統學習排版知識，寫模版、寫宏包

你可能確實要拿出「鑽研編譯原理的勁兒」。排版的水可能比你想像的還深，而 TeX 跟主流編程語言大相徑庭也需要一些時間來掌握。Google、GitHub 和 StackExchange 將會是你的好朋友，以及，英語是必須的。

4. 我要寫世界上最好的排版引擎幹掉 TeX

請聯繫 @李阿玲（逃

5. 老闆讓我幹什麼我就幹什麼

祝好運，不送。

入門教程

知乎上老生常談的問題，前輩們的回答可以認真讀：

• 如何在 1 小時內快速入手 LaTeX？ - 劉海洋的回答
• 如何從零開始，入門 LaTeX？ - 孟晨的回答
• 自學 LaTeX 可以讀什麼書入門？ - 劉海洋的回答、孟晨的回答

當然也可以選擇看下面的：

剛入門的頭幾步將會在很大程度上決定之後的路好不好走。不論是看了譚浩強的 C 語言，還是不知道從哪裡找來的 LaTeX 教程，後果都是出現一堆稀奇古怪的問題，自己還找不到解決方法。所以，我們非常希望新手能夠選擇一些靠譜、合適的入門教材。

現在（2019 年 7 月），我們只推薦下面這些材料：

• 一份（不太）簡短的 LaTeXe 介紹（lshort） [PDF] [GitHub]
• 一份簡短的安裝 LaTeX 的介紹 [GitHub]
• @劉海洋 的《LaTeX 入門》（跳過 CTeX 套裝的部分）

lshort 強烈建議完整讀一遍，普通文章排版所需要的幾乎全部功能這裡都包含了。找不到直接去《LaTeX 入門》的相關章節翻閱（當字典查）。其他網上的資料，wikibook 上的教程可以參考，知乎請認準那幾位的回答，b 站魚龍混雜謹慎使用，而 csdn、科學網博客、x 度文庫請絕對不要看。

有人帶自然很好，但請先判斷他的水平。最簡單的依據：如果他還在用 CTeX 套裝，或 WinEdt 7.0 及以下，或代碼裡面出現了 CJK 環境，那麼請立刻遠離（當然，僅限 LaTeX 方面）。

發行版建議使用最新版 TeX Live（目前是 2019），或者在線使用 Overleaf（最好自備梯子）。CTeX 套裝絕對不要用。

最後一點提醒：如果你不小心學了假的 LaTeX，建議回頭重讀一遍以上列出的入門材料。

如何找模版

為了寫出符合學校要求的論文，誰都需要一個好用的模版，而不出意外地，我也是其中的一員。

• 實驗室的演算法大神世豪搞了個模板用，折騰折騰，一編譯，好使！
• 我拿來用，不好使，浪費了一兩天時間。
• 實驗室編碼大神益達用了個模板，折騰折騰，編譯一下，好使！
• 我換成他的，不好使，浪費了一兩天時間。
• 我上 Github 下載了一個的 ZJUthesis
• 不好使，浪費了兩三天吧。
• 換成另一個 github 上的 zju 模板，不好使。
• 這時候數學優化大神蘿蔔給我了一個師兄自用的模板。
• 我試了一下午，不好使。

懷疑你在黑 zju 然而我找不到證據……

首先，學長 / 學姐 / 大神 / 巨佬拷給你的模版幾乎一定是不好用的。目前大多數高校的模版都掛在了 GitHub 上面，有些還發布在了 Overleaf 或者 CTAN 上面，請認準這些（半）官方渠道。（請問你會選擇 pip、Anaconda，還是濕兄拷給你的 TensorFlow ？）

其次，GitHub 上面找模版，居然還去試了幾個。沒有經驗可以告訴你一點經驗：

• 沒有 README、LICENSE、.gitignore 的可以直接忽略（原文章居然吐槽了 LICENSE 這我還能說什麼？）
• Commit 很少，幾個月內又沒有什麼更新，建議不要用
• Issue 越多說明積累的問題越多，也就意味著用戶越多，當然前提是作者要去處理 issue
• Star、fork、watch 都很少的話請小心使用，不過也有可能是比較新的緣故
• 使用 dtx 作為源代碼、有測試文件、用 ci 的模版往往更靠譜一些

最後，下載下來覺得不好使。請問有看過模版的使用說明嗎？有完全按照模版提供的編譯說明來跑嗎？這樣再出現問題應該直接聯繫模版作者 or 跑去 GitHub 提 issue。一個靠譜的模版作者應當可以解決你的問題。

Debug 策略與提問的姿勢

生活總是充滿苦澀，我選擇了一個 error 最少的 cls 文件，從 0 開始，一點一點把各個模板好使的語句慢慢粘貼過來，形成一個巨大的 tex 文件。

原文作者顯然完全沒有 debug 的能力。首先要做的是分解問題，而不是把所有東西全部堆過來來碰運氣，這樣只能變成一座 shit mountain。

我們這裡可以通過一個例子說明：ctex-kit #331

原來的問題簡單得很：

documentclass{ctexart}
usepackage{fancyvrb}
egin{document}
egin{Verbatim}
鳶尾花
end{Verbatim}
end{document}

可以看到左邊的引號後面多出了一個空格：

然而，該用戶因為知道「zhspacing 包是用來解決中英文之間的空格，包括代碼塊中中英文之間的空格」，所以想用 zhspacing 包來處理，結果卻遇到了 Linux 下沒有 SimSun 字體而產生的錯誤，這才過來報告 issue。

該用戶發現在 Windows 上配合 zhspacing 包可以實現想要的效果：

觀察仔細可以發現這裡的引號其實是蝌蚪引號 U+2018 Right single quotation mark，而不是編程語言中一般用的 U+0027 Apostrophe。所以這其實並不是正確的解決方案。

暫且不討論引號的問題。所謂的「窮折騰」從一開始就完全帶偏了節奏，也在一定程度上招致了開發者的不滿。我們可以看到，該用戶自始至終就沒有提供一份足以展示問題的代碼，而只有代碼本身才是解決問題的鑰匙。

接下來，@yihui 提供了代碼（第一份代碼只是引號的正常寬度，與本問題無關），那麼問題就好解決多了：

documentclass[UTF8]{ctexart}
usepackage{color}
usepackage{fancyvrb}

ewcommand{VerbBar}{|}

ewcommand{VERB}{Verb[commandchars=\{}]}
DefineVerbatimEnvironment{Highlighting}{Verbatim}{commandchars=\{}}
usepackage{framed}
definecolor{shadecolor}{RGB}{248,248,248}

ewenvironment{Shaded}{egin{snugshade}}{end{snugshade}}

ewcommand{StringTok}[1]{ extcolor[rgb]{0.31,0.60,0.02}{#1}}

egin{document}

egin{Shaded}
egin{Highlighting}[]
StringTok{"鳶尾花"}
end{Highlighting}
end{Shaded}

end{document}

這個代碼已經足夠簡短，並且也展示了問題。當然還可以繼續簡化：

• 顏色有關的代碼可以通通刪去
• 定義的 VerbBar 等命令沒用到，刪掉
• Highlighting 用 fancyvrb 宏包自帶的 Verbatim 代替

這樣我們就得到了一開始的那份問題代碼，於是終於可以開始 debug 了。

1. 使用 LaTeX 的標準 verbatim 環境（注意大小寫），發現是正常的。

2. 使用 article + xeCJK 代替 ctexart 文檔類，同樣出現問題。

3. 在 xeCJK 的文檔中搜索有關抄錄環境的問題，可以找到 Verb 選項和 xeCJKVerbAddon 等命令。根據說明，我們可以把它添加到 fancyvrb 宏包的 formatcom 選項中：

documentclass{article}
usepackage{xeCJK,fancyvrb}
DefineVerbatimEnvironment{Highlighting}{Verbatim}{%
commandchars=\{}, formatcom=xeCJKVerbAddon}
egin{document}
egin{verbatim}
鳶尾花
end{verbatim}
egin{Verbatim}
鳶尾花
end{Verbatim}
egin{Highlighting}
鳶尾花
end{Highlighting}
end{document}

這時修補過的 Highlighting 就可以表現正常了（Verbatim 用來對照）：

4. 查看代碼可以看出，xeCJK 僅為 verbatim@font 打了補丁，而這個是 verb 或者 verbatim 環境內部所使用的字體樣式。如果是其他抄錄環境則需額外定義（listings 宏包由於使用自己的一套機制 xeCJK 對此單獨做了修補）。

到此問題便得到了解決。我們可以總結一下：

• 有問題請儘快整理出示例，向更有經驗的人求助。一知半解 + 窮折騰很有可能會把問題代入死衚衕。
• 一定要給出最小工作示例（MWE）：
• 應當是一個完整的、在你的電腦上能編譯的 LaTeX 文檔
• 何為完整？以 documentclass 開始，以 end{document} 結束
• 在你電腦上的編譯結果，應當能復現問題，或體現需求
• 與復現問題和體現需求無關的代碼應儘可能少，如各種宏包的載入、自定義的命令等
• 嘗試更換為標準文檔類（article、ctexart）等
• 如果復現問題需要其他文件（圖片、bib 等），請把它們和 LaTeX 文檔一起打包
• 給出 MWE 的過程就是 debug 的過程。這時需要進一步刪掉無關代碼，呈現問題原貌，此時可以：
• Print 大法好！TeX 的 show 命令可以展示宏的內容，而 LaTeX3 還提供了更多的類似函數
• 一點點注釋掉無關內容，二分法定位
• 插斷點，實際上 show 的時候編譯會中止，我們常利用多個 show 來定位 bug

TeX 要面向現代化、面向世界、面向未來

眾所周知，(La)TeX 是一個很古老的東西，很多問題歸根結底都源自於歷史的侷限。「新一代」的引擎 XeTeX 和 LuaTeX 十多年前就進了 TeX Live，阿玲姐姐的那一個也指日可待。然而卻還總有人試圖靠 8-bit 引擎來解決 CJK 問題，對這樣固步自封的行為我們表示遺憾。

語言方面，宏語言捉襟見肘的表達能力確實是一個問題。但 LaTeX3 也在逐漸成熟，二十多年積累下來的方方面面的經驗使得它正在成為標準庫一樣的東西。當有了統一的框架，可以想見開發與使用都將變得更加容易。與此同時，ConTeXt 那邊也在持續地嘗試新的想法，對 variable fonts 和 color fonts 的支持 2017 年就已經做了。所以，在追趕潮流的能力上 TeX 絲毫不比那幾家商業公司差多少（誤）。

作為開發者，我們自然希望用戶的使用門檻可以一降再降，遇到的坑也能夠越來越少。不過，這都建立在用戶自己有嘗試、探索、討論與交流的熱情之上。遇到問題，只會無頭蒼蠅一樣四處亂撞，或者陰陽怪氣地嘲諷，我們只能提醒你：恐怕使用 Word 的能力你也沒有。

ye

參考

1. ^傳統上 TeX 的流程是先生成 dvi，再接後續操作（即「驅動」，如 dvips、dvipdf、dvipdfm、dvipdfmx 等）。插圖、彩色支持是在第二步做的，TeX 並不知道具體細節，所以需要手動給 graphicx 加上選項以指定驅動使其能夠寫入特定代碼（special 命令）。但現在主流都是 pdfTeX、XeTeX、LuaTeX 等「一步到位」的東西，宏包可以自動判斷，不需要也不建議手動指定。
2. ^楷書、斜體、連筆，義大利體的漢字匹配方案探索 https://mp.weixin.qq.com/s/gd2rB0hjZhPGavGcZKtSOg

推薦閱讀：