本地安装的R包Vignettes无法访问问题求助

1. 强制重装并构建Vignettes #

先彻底卸载现有包，清理残留的构建文件，再重新安装并指定构建Vignettes：

remove.packages("dogesr")
# 删除旧的doc目录和vignette元数据文件
unlink(c("doc", "Meta/vignette.rds"), recursive = TRUE)
# 重新安装并强制构建Vignettes
devtools::install(".", build_vignettes = TRUE)

2. 手动重建Vignettes索引 #

如果执行build_vignettes()后，包目录下的Meta/vignette.rds文件未生成，手动触发索引构建：

tools::buildVignettes(dir = ".", tangle = TRUE)

执行完成后再次重新安装包。

3. 核对Vignettes源文件配置 #

• 检查vignettes/目录下的.Rmd或.Rnw源文件，确保YAML头部的VignetteIndexEntry字段与你调用vignette()时的名称完全匹配。例如doges-terms.Rmd的头部需包含：

---
title: "Doges Terms"
output: rmarkdown::html_vignette
vignette: >
  %\VignetteIndexEntry{doges-terms}
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteEncoding{UTF-8}
---

这里的VignetteIndexEntry值就是vignette()调用时需要传入的名称，大小写、符号必须一致。

• 确认源文件名与索引条目对应，避免因名称不匹配导致无法识别。

4. 验证包的doc目录路径 #

运行以下命令查看包的doc目录是否存在：

system.file("doc", package = "dogesr")

如果返回空字符串，说明包安装异常；如果返回有效路径，手动打开该路径确认html文件是否实际存在。

5. 重启R会话 #

R有时会缓存旧的包信息，重启会话后再尝试调用vignette("doges-terms", package = "dogesr")或browseVignettes("dogesr")。

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