在R Markdown PDF中添加本地图片预览正常但编织报错的问题

这个问题我之前碰过好多次，核心原因就是你写的路径格式出错了——你用的/C:/Users/User/Pictures/Capture.PNG开头多了个斜杠，这会让pandoc误以为是Unix风格的根路径，自然找不到Windows系统里的图片。另外，当图片不在当前工作目录时，确实需要特别注意路径的写法，下面给你几种靠谱的解决办法：

方法1：修正绝对路径的正确写法 #

Windows系统的绝对路径有两种正确写法，选一种就行：

• 用正斜杠（推荐，因为R和pandoc都能直接识别）：
  如果你用Markdown原生语法插入图片：

  ![截图](C:/Users/User/Pictures/Capture.PNG)
  

  如果你用R代码块调用knitr插入：

  knitr::include_graphics("C:/Users/User/Pictures/Capture.PNG")
  

• 用转义反斜杠（R里反斜杠是转义字符，所以要写两个）：

  knitr::include_graphics("C:\\Users\\User\\Pictures\\Capture.PNG")
  

方法2：用相对路径（更推荐，移植性更强） #

把图片放到你的R Markdown文件所在的工作目录下，比如专门建一个images文件夹，把图片放进去，然后用相对路径引用：

• Markdown语法：

  ![截图](images/Capture.PNG)
  

• R代码块：

  knitr::include_graphics("images/Capture.PNG")
  

这种方式的好处是，不管你把项目移到哪台电脑，只要图片和Rmd文件的相对位置不变，就能正常显示。

方法3：用here包管理路径（专业项目必备） #

如果你的项目结构比较复杂，推荐用here包来自动识别项目根目录，避免手动写路径的麻烦：

1. 先安装并加载包：

   install.packages("here")
   library(here)
   

2. 然后引用图片（假设图片在项目根目录下的Pictures文件夹里）：

   knitr::include_graphics(here("Pictures", "Capture.PNG"))
   

here会自动根据你的Rmd文件位置定位项目根目录，不管你在哪运行代码，路径都不会错。

额外注意事项 #

• 检查路径里的空格和大小写：如果路径有空格（比如C:/Users/My User/Pictures），确保用引号把路径括起来；另外虽然Windows不区分大小写，但pandoc可能敏感，要保证文件名（比如.PNG和.png）和路径里的拼写完全一致。
• 确认图片真的存在：双击路径里的地址，看看能不能直接打开图片，避免用户名、文件夹名拼写错误。

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