R Markdown knit 为 PDF 时 GGplot 异常显示在标题上方的问题

排查修复方向 #

1. 优先处理LaTeX浮动体自动移位问题 #

R Markdown 编译为PDF时，ggplot输出的图表默认会被包裹进LaTeX浮动环境，LaTeX为了减少跨页浪费，会自动调整图表位置，不受源码书写顺序的严格约束。其余图表显示正常，只是因为这些图刚好落在页面空余位置足够的区域，没有触发自动移位规则；Count、Percent两个图恰好遇到当前页剩余空间不足的情况，就被自动移到上方的空余区域，形成错位。

• 对这两个出问题的图表所在代码块，单独添加块参数fig.pos = "H"，强制图表固定在源码对应的当前位置，完全禁止浮动。

  注意：不要用小写的fig.pos = "h"，小写参数仅表示“尽量放在当前位置”，仍允许浮动；如果添加大写H参数后不生效，需要在文档顶部YAML的header-includes字段中添加\usepackage{float}作为依赖包。

• 仅在标题和代码块之间加空行的操作对这类问题无效，因为空行不会改变LaTeX的浮动判定逻辑。

2. 排查排版拥挤导致的位置错位 #

LaTeX默认规则是不允许标题出现在页面最后一行的，如果"Count"标题刚好落在上一页的末尾，系统会自动把标题移到下一页开头，而对应的图表仍留在上一页，就会形成“图在标题上方”的视觉错位。

• 可以在"Count"标题前临时加\newpage强制分页，观察排版是否恢复正常；如果恢复正常，说明就是页面空间不足触发的错位。
• 对比两个出问题图表与其他正常图表的fig.height、fig.width参数：如果这两个图的尺寸明显更大，当前页面剩余空间无法容纳，就会触发移位，适当缩小这两个图的尺寸即可解决。

3. 排查全局配置与源码逻辑问题 #

• 检查全局代码块参数：如果全局配置了fig.pos = "!htbp"这类允许图表向上浮动的规则，其余位置的图因为空间充足不受影响，只有这两个空间不足的图会触发移位，给两个问题图单独覆盖fig.pos = "H"参数即可绕开全局规则。
• 开启YAML中的keep_tex: true选项，编译完成后打开同目录生成的.tex源码文件，搜索"Count""Percent"对应的文本位置，直接查看图表对应的\begin{figure}环境实际插入的位置，可明确定位是Rmd源码结构错位，还是LaTeX自动移位导致的问题。

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