knitr中subfigure渲染异常的排查与最小改动适配需求

首先，咱们先揪出最核心的问题：你的knitr示例LaTeX导言区漏掉了graphicx包！这个包是LaTeX处理\includegraphics命令的基础，没有它，LaTeX根本不知道怎么加载图片——而你的Sweave示例里是包含这个包的，所以能正常工作。

接下来，我给你修复后的完整代码，同时修正一个小的拼写错误（fig.with应该是fig.width），确保最小改动就能复用现有代码：

\documentclass[a4paper]{article}
\usepackage{graphicx} % 必须添加这个包！
\usepackage{subcaption}
\usepackage{float}
\graphicspath{{figure/}}
\title{Fixed: subfigure with knitr}
\date{}
\begin{document}
\maketitle
<<init, include=FALSE>>=
library(knitr)
# 统一设置图片选项，避免重复写参数
opts_chunk$set(fig.width = 6, fig.height = 6, fig.path = "figure/")
@
<<knitrfig, include=FALSE>>=
mapply(function(X) plot(X, main=X), c(1:2))
@
Now the subfigures should render properly!
\begin{figure}[htbp]
 \centering
 \begin{subfigure}[b]{0.45\textwidth}
 \centering
 \includegraphics{knitrfig-1}
 \caption{subcaption1}
 \end{subfigure}%
 ~
 \begin{subfigure}[b]{0.45\textwidth}
 \centering
 \includegraphics{knitrfig-2}
 \caption{subcaption2}
 \end{subfigure}
 \caption{Subfigures now work correctly with knitr}
\end{figure}
\end{document}

额外说明（为什么之前失效） #

除了缺少graphicx包，还有两个小细节需要注意：

1. 你写的fig.with是拼写错误，正确的参数名是fig.width——这个会影响图片尺寸，但不是导致不显示的直接原因。
2. knitr默认生成的图片文件名是[代码块标签]-[数字].[格式]（比如knitrfig-1.pdf），不过因为你设置了\graphicspath{{figure/}}，且LaTeX会自动尝试补全常用图片扩展名，所以不用手动加.pdf也能正常找到图片。

最小改动的优化建议 #

如果你有很多现有报告要迁移，只需要给每个knitr的.Rnw文件添加\usepackage{graphicx}，并修正代码块里的参数拼写错误即可，完全不用改动你现有的subfigure代码结构，完美复用现有内容。

内容的提问来源于stack exchange，提问作者Cedric