因vignette无法找到子Rmd文件导致R包构建失败

听起来你是想把vignette拆成可复用的子Rmd模块，但踩了R包构建流程里的常见坑——构建时vignette会被单独复制到临时目录处理，子文档没同步过去，所以才会报找不到文件的错误。下面给你几个实用的解决办法：

方法1：子文档放vignettes目录，用system.file指定路径 #

把你的子文档child_doc.Rmd和主vignetteVignette.Rmd放在同一个vignettes目录下，然后在主文档的child chunk里用system.file获取正确路径：

```{r child=system.file("vignettes", "child_doc.Rmd", package = "你的包名")}

*兼容本地预览小技巧：* 本地直接Knit时可能还没安装包，加个判断就能同时适配本地和构建场景：
```r
```{r child=if (file.exists("child_doc.Rmd")) "child_doc.Rmd" else system.file("vignettes", "child_doc.Rmd", package = "你的包名")}

## 方法2：子文档放`inst/doc`目录共享
如果想让子文档能被包的用户复用，可以把它们放到`inst/doc`目录下，构建包时这些文件会被安装到包的`doc`目录。然后在vignette里这样引用：
```r
```{r child=system.file("doc", "child_doc.Rmd", package = "你的包名")}

## 方法3：用devtools模拟构建测试
本地开发时，别直接点RStudio的Knit按钮，改用`devtools::build_vignettes()`来测试，它会模拟R包构建的完整流程，能提前发现路径问题，避免到`R CMD build`时才报错。

## 关键注意事项
- 绝对不要用绝对路径！不同环境下绝对路径肯定失效，必须依赖`system.file`获取包内文件的标准路径。
- 确保子文档放在`vignettes`或`inst/doc`目录下，这两个目录的文件默认会被打包进R包，不会被遗漏。
- 如果子文档有额外依赖，一定要在DESCRIPTION文件里声明对应的包，不然构建时会触发依赖缺失错误。

> 补充下报错本质：R构建vignette时，会把主Rmd复制到临时工作目录单独处理，但子文档不会被自动复制过去，所以直接用相对路径会找不到。而`system.file`是从包的源目录/安装目录读取文件，完全避开了临时目录的坑。

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