插入图片

使用 graphicx 宏包的 \includegraphics 插入项目中的图片。将图片与源文件一起保存，并用相对路径引用，避免依赖个人电脑上的绝对路径。

EasyLaTeX 编译器设置：XeLaTeX + ctex；需加载 graphicx。本页涉及外部图片的示例假设项目中存在对应文件。

准备图片文件#

在 EasyLaTeX 文件树中上传图片，按需要移动到 images/ 目录。以下例子将 main.tex 放在项目根目录：

my-document/
├── main.tex
└── images/
    └── experiment-result.png

图片文件名使用英文、数字、连字符或下划线，例如 experiment-result.png。避免空格、中文文件名和只在某个操作系统中可用的特殊字符，以减少协作和在线编译中的路径问题。

插入一张图片#

在导言区加载宏包：

\usepackage{graphicx}

然后在正文中引用相对路径：

\includegraphics{images/experiment-result.png}

若文件扩展名明确，按实际名称书写。常见编译器通常支持 PNG、JPEG 和 PDF；矢量图优先使用 PDF，照片或屏幕截图常使用 PNG 或 JPEG。

控制大小#

不要依赖图片原始像素大小。使用 width、height 或 scale 显式设置尺寸：

\includegraphics[width=0.7\linewidth]{images/experiment-result.png}

\linewidth 是当前位置可用的行宽，因此 0.7\linewidth 会随单栏、双栏或列表环境自动调整。通常优先使用相对宽度，而不是固定 12cm。

保持纵横比时只设置宽度或高度之一。若必须限制两者，加入 keepaspectratio：

\includegraphics[
  width=0.8\linewidth,
  height=6cm,
  keepaspectratio
]{images/experiment-result.png}

图片路径与格式#

当项目有许多图片时，可以在导言区定义搜索路径：

\graphicspath{{images/}}

之后可以简写为：

\includegraphics[width=0.7\linewidth]{experiment-result.png}

\graphicspath 的每一项都需要一层花括号。它只影响图片查找；源文件中的其他路径仍按项目结构书写。

裁剪与旋转#

trim 按“左、下、右、上”的顺序裁剪，配合 clip 才会隐藏裁掉部分：

\includegraphics[
  width=0.7\linewidth,
  trim=1cm 0.5cm 1cm 0.5cm,
  clip
]{images/experiment-result.png}

旋转使用 angle：

\includegraphics[width=0.6\linewidth,angle=90]{images/experiment-result.png}

裁剪是版面调整，不应借此删除图中必需的比例尺、坐标轴、数据来源或图例。

常见问题#

File ... not found#

检查文件名、扩展名和大小写是否完全一致，确认图片已上传或复制到项目目录。不要使用 C:\Users\... 等本地绝对路径。

图片超出页边距#

改用 width=\linewidth 或更小的比例。不要通过缩小整篇文档字体来迁就一张图片。

图片位置与说明分开#

将图片放进 figure 环境，并使用 \caption 与 \label，见图题、标签与浮动位置。

完整示例#

将一张名为 experiment-result.png 的图片放入 images/ 后，以下文件可编译：

\documentclass[UTF8,a4paper,12pt]{ctexart}
\usepackage{graphicx}
\graphicspath{{images/}}

\begin{document}

下面插入一张宽度为当前行宽 70\% 的图片。

\begin{center}
  \includegraphics[width=0.7\linewidth]{experiment-result.png}
\end{center}

\end{document}