跳到正文
Scissor LaTeX

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 cm，但它保持了原始大小：

height= 被忽略

LaTeX导言区： \usepackage{graphicx}在编辑器中打开
\includegraphics[height=1cm]{graphicx-photo.png}

请改用 width=。要让图像大约高 1 cm，可以根据宽高比算出宽度（这张是 16 比 9，所以约 1.8 cm）。

缺失的文件，或排版器无法读取的格式，会变成一个虚线占位框，并在“问题”标签页中注明：

缺失的图像显示为占位框

LaTeX导言区： \usepackage{graphicx}在编辑器中打开
\includegraphics[width=5cm]{results/plot.eps}

“问题”标签页： Images not in the project: results/plot.eps

\resizebox 能把 TikZ 图形缩放到指定宽度：

包裹 TikZ 图形的 \resizebox

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