常見錯誤與修正方法
大多數問題都不會讓文件停下來：未知的指令會被略過並列在「問題」分頁中，無法讀取的公式會以紅色顯示並在那裡列出，缺少的圖片或引用會在原處標示；只有 EPS 圖片會讓整份文件停止。
問題如何回報
TeX 安裝環境會在第一個錯誤處停下來，並詢問你要怎麼做。Scissor LaTeX 則會繼續下去：它盡可能排版文件的內容，並把無法處理的部分列在預覽下方的問題分頁中。每一筆項目在已知的情況下會附上對應的行號，點選它就會跳到那裡。
結果分成四種：
| 你看到的 | 代表的意思 | 該看哪裡 |
|---|---|---|
| 「問題」分頁中有訊息，文件正常 | 有內容被略過或省略。 | 下面各節。 |
| 公式顯示為紅色的原始碼 | 該公式無法讀取。 | 紅色公式 |
紅色的 [key?] 或灰色虛線框 | 缺少引用或圖片。 | 缺少的引用和圖片 |
| 完全沒有頁面，頂端有一則錯誤 | 整份文件失敗。 | 整份文件無法排版時 |
「Skipped N unknown commands」
這是你最常看到的訊息，相當於 LaTeX 的「Undefined control sequence」。Scissor LaTeX 不認得的指令會被略過：指令名稱消失，大括號中的文字則會保留。
未知的指令：名稱消失，文字保留
The value is \highlightvalue{44} and the unit is \unitname{kg}.「問題」分頁： Skipped 2 unknown commands: \highlightvalue, \unitname
處理方式：
- 檢查拼字。
\textbf可以使用，\textbold則不行。 - 如果指令來自某個套件，請在套件頁面中查詢該套件。有些指令有簡單的替代寫法。
- 如果是你自己的指令，請確認它在使用之前已經用
\newcommand定義（參見自訂指令）。
未知的環境則不同：它會被直接移除，內容保留，而且不會有任何訊息。如果文字看起來沒有套用格式，請檢查環境名稱。
「Package ... is not available here」
\usepackage 永遠不會失敗。Scissor LaTeX 不認得的套件會在「問題」分頁中註明，它的格式也不會被套用。文件的其餘部分照常排版，而該套件中不認得的指令會被回報為未知。
無法使用的套件
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}「問題」分頁： Package fancyboxes2 isn't supported in the preview, so its formatting is not applied. If it is your own package, add fancyboxes2.sty to the project.
紅色公式
當公式中有數學轉換器無法讀取的內容時，該公式會顯示為紅色的原始碼。文件的其餘部分不受影響。「問題」分頁會列出該公式、它的行號和原因，例如「This formula could not be read: \symbf{v} (unknown command: \symbf)」；超過十個公式後，會再用一行列出其餘公式的數量。
無法使用 \symbf，所以公式變成紅色
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.以紅色顯示： 無法讀取公式，因此改為顯示其原始碼。
常見的原因和修正方式：
| 原因 | 修正方式 |
|---|---|
\abs{x}、\norm{x}、\dv{f}{x}（physics） | \left\lvert x \right\rvert、\left\lVert x \right\rVert、\frac{df}{dx} |
\SI{44}{\kilo\gram}（siunitx） | 44\,\mathrm{kg} |
\sideset | 改寫公式，不使用它。 |
缺少成對的 $ | 把公式關閉。沒有關閉的 $ 不會變成紅色：它會把所在段落的其餘部分，一直到下一個空白行，都變成連在一起的斜體數學式。 |
缺少的引用和圖片
不在任何 .bib 檔案中的引用鍵會印成紅色的 [key?]，「問題」分頁也會列出缺少的鍵。缺少的圖片會變成附有檔名的灰色虛線框。
不在專案中的圖片
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
「問題」分頁： Images not in the project: figures/plot.png
請以相同的路徑把檔案上傳到專案中，或修正路徑。沒有副檔名時，會找到 .png、.jpg、.jpeg 和 .svg 檔案；PDF 和 EPS 圖片也會顯示虛線框（參見圖片與影像）。引用的部分請見參考文獻與引用。
其他訊息
| 訊息 | 意思 | 處理方式 |
|---|---|---|
| 「N included files are not part of this conversion」 | \subfile、\import、\lstinputlisting、\inputminted 或 \includepdf 被略過。 | 改用 \input，或把內容貼進來。 |
| 「File not found: ...」 | \input 或 \include 指定的檔案不在專案中。 | 從專案的最上層資料夾檢查路徑。 |
| 「N pictures of an unsupported kind are not included」 | tikzcd、circuitikz、forest 或 picture 環境被省略。 | 參見用 TikZ 繪圖。 |
| 「TikZ option '...' is not supported yet」 | 圖形使用了繪圖引擎不認得的選項。圖形會在沒有該選項的情況下繪製。 | 檢查該選項，或把它拿掉。 |
| 「Layout in the style of ... Not official.」 | 研討會類別或套件切換到了仿製版面。 | 不需要處理；這只是資訊。 |
| 「Macro expansion stopped at the safety limit」 | 某個指令展開成它自己，或展開成大量文字。 | 找找看有沒有使用自己名稱的 \newcommand。 |
| 「This formula could not be read: ...」 | 公式以紅色顯示；原因寫在括號中。 | 參見紅色公式。 |
| 「References to labels that do not exist (shown as ??): ...」 | \ref、\eqref、\pageref 或 \cref 指定的標籤沒有定義，或位於紅色公式上。 | 檢查標籤的拼字。 |
| 「Bibliography style ... is not available; using numbered references [1] instead」 | \bibliographystyle 指定的格式不在清單中，例如 alpha。 | 從清單中挑選一種格式，或保留編號式參考文獻。 |
| 「Skipped .bib entries: ...」 | .bib 檔案中的這些條目無法讀取（缺少大括號、重複的鍵）；其他條目會照常使用。 | 修正所列行號上的條目。 |
在這裡不會看到的 LaTeX 錯誤
有些經典的 LaTeX 錯誤在 Scissor LaTeX 中不會讓任何東西停下來，因此很容易被忽略：
| LaTeX 錯誤 | Scissor LaTeX 的處理方式 |
|---|---|
正文中的 x_1 造成「Missing $ inserted」 | 照字面印出 x_1。請把數學式放在 $...$ 中。 |
| 「Misplaced alignment tab character &」 | 照字面印出 &。要表示 & 符號，請寫 \&。 |
| 「Extra }, or forgotten $」 | 忽略不成對的大括號。 |
| 「\begin{itemize} ended by \end{document}」 | 自動幫你關閉環境。 |
| 「Reference ... undefined」 | 印出粗體的 ??；「問題」分頁會列出缺少的標籤。 |
LaTeX 會拒絕的文字
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.這些文件在 TeX 安裝環境中仍可能失敗，所以即使預覽看起來沒問題，也請修正它們。
與 TeX 安裝環境的差異
依症狀整理的檢查清單，請見疑難排解。
常見問題
「Undefined control sequence」是什麼意思？
LaTeX 不認得某個指令，通常是因為拼錯字或缺少套件。在 Scissor LaTeX 中，同樣的情況會在「問題」分頁中顯示為「Skipped N unknown commands」，而文件仍然會排版。
為什麼我的公式是紅色的？
公式中含有數學轉換器不認得的指令，例如 \symbf 或 \abs。「問題」分頁會列出它。請替換該指令；本頁的表格列出了常見的替代寫法。
為什麼我的文件中出現 [key?]？
這個引用鍵不在專案的任何 .bib 檔案中。請檢查拼字，並確認 .bib 檔案已經上傳。
本頁的每個範例都在建置網站時由 Scissor LaTeX 排版。 最後更新：2026-11-07