跳到主要內容

Scissor LaTeX 中的 graphicx 和 \includegraphics

graphicx 套件在 Scissor LaTeX 中部分可用:\includegraphics 能顯示專案中的 PNG、JPG、SVG 和 PDF 檔案,並讀取 width=;height、scale、angle、trim 和 clip 會被忽略,\rotatebox 不會旋轉,\scalebox 和 \resizebox 只會縮放 TikZ 圖。

套件的用途

graphicx 提供 \includegraphics[options]{file} 來放置圖片檔,以及能縮放、調整大小或旋轉內容的方框:\scalebox、\resizebox 和 \rotatebox。

在這裡可用的功能

指令或選項在 Scissor LaTeX 中備註
\includegraphics{file.png}可用專案中的 PNG、JPG、JPEG、SVG 和 PDF 檔案。沒有 width= 時,圖片保持原本的大小。
\includegraphics{file}(沒有副檔名)部分支援會找到 .png、.jpg、.jpeg 和 .svg 檔案。PDF 需要寫出副檔名:{plot.pdf}。
width=0.5\linewidth, width=4cm可用長度,或 \linewidth、\textwidth 的比例。高度依長寬比而定。
height=, scale=, angle=, trim=, clip, keepaspectratio忽略直接忽略,沒有訊息。
EPS 檔案,或不在專案中的檔案預留位置顯示一個寫著檔名的虛線框,並在「問題」分頁中註記「Images not in the project」。
一行中的多張圖片部分支援每張圖片都會放在自己的一行,在段落中也一樣。只有在 tabular 的儲存格中,圖片才能並排。
\graphicspath{...}忽略會被接受,沒有訊息。
\scalebox{2}{...}, \resizebox{w}{!}{...}部分支援只會縮放其中的單一 TikZ 圖;文字和圖片保持原本大小。
\rotatebox{90}{...}忽略內容會保留,但不會旋轉。
\reflectbox{...}不支援會被略過並在「問題」分頁中註記;內容會保留。

範例

放在有圖說的 figure 中、寬度為行寬一半的圖片:

搭配 width= 的 \includegraphics

LaTeX導言區: \usepackage{graphicx}在編輯器中開啟 (在新分頁中開啟)
\begin{figure}[h]
  \centering
  \includegraphics[width=0.5\linewidth]{graphicx-photo}
  \caption{Weekly orders in John Doe's shop.}
  \label{fig:orders}
\end{figure}
Figure~\ref{fig:orders} shows four weeks.

SVG 和 PDF 檔案也能用。PDF 請寫出副檔名:

SVG 和 PDF 圖片

LaTeX導言區: \usepackage{graphicx}在編輯器中開啟 (在新分頁中開啟)
\includegraphics[width=4cm]{graphicx-diagram.svg}

\includegraphics[width=4cm]{graphicx-chart.pdf}

height= 會被忽略。這張圖片原本應該是 1 公分高,但它保持原本的大小:

height= 會被忽略

LaTeX導言區: \usepackage{graphicx}在編輯器中開啟 (在新分頁中開啟)
\includegraphics[height=1cm]{graphicx-photo.png}

請改用 width=。如果要讓圖片大約 1 公分高,請依它的長寬比算出寬度(這張是 16 比 9,所以約 1.8 公分)。

找不到的檔案,或排版器無法讀取的格式,會變成虛線的預留位置,並在「問題」分頁中註記:

找不到的圖片會顯示預留位置

LaTeX導言區: \usepackage{graphicx}在編輯器中開啟 (在新分頁中開啟)
\includegraphics[width=5cm]{results/plot.eps}

「問題」分頁: Images not in the project: results/plot.eps

\resizebox 會把 TikZ 圖縮放到指定的寬度:

用 \resizebox 包住 TikZ 圖

LaTeX導言區: \usepackage{graphicx,tikz}在編輯器中開啟 (在新分頁中開啟)
\resizebox{3cm}{!}{%
  \begin{tikzpicture}
    \draw (0,0) rectangle (4,2);
    \draw (0,0) -- (4,2);
    \node at (2,2.4) {44};
  \end{tikzpicture}}

相容性

  • 從 TeX 安裝環境搬到這裡:請用相同的資料夾名稱上傳圖片檔。用 height= 或 scale= 設定大小的圖片會以原本大小顯示;請改用 width=。沒有寫副檔名的 PDF 圖片需要加上 .pdf。
  • 從這裡搬到 TeX 安裝環境:pdfLaTeX 無法讀取 SVG 檔案。請把它們轉換成 PDF(或使用 svg 套件),或只使用 PNG、JPG 和 PDF 圖片。

完整手冊在 CTAN 上:ctan.org/pkg/graphicx。關於圖片、圖說和位置,請見圖片與影像和浮動體:放置圖片與表格。

常見問題

為什麼我的圖片太大?

沒有 width= 時,圖片會保持原本的大小,而 height= 和 scale= 會被忽略。請加上 width=0.8\linewidth 或固定寬度,例如 width=6cm。

可以插入 PDF 圖片嗎?

可以。把 PDF 上傳到專案,並寫出含副檔名的檔名,例如 \includegraphics[width=\linewidth]{plot.pdf}。

為什麼我的圖片顯示成虛線框?

檔案不在專案中、路徑不同,或者它是 EPS 檔案。「問題」分頁會列出找不到的檔案。

本頁的每個範例都在建置網站時由 Scissor LaTeX 排版。 最後更新:2026-11-07