首次开发R包：vignette中执行library(mypackage)报错求助

嘿，这个坑我刚开发第一个R包的时候也踩过！咱们先搞清楚问题根源，再一步步解决：

问题原因 #

devtools::load_all()只是临时加载开发中的包内容到当前R会话，并没有把包真正安装到你的系统R库里面。而library(mypackage)是从系统库中查找并加载已安装的包——所以直接跑library()会报错，先跑load_all()再跑library()能“凑效”，其实是因为R已经在当前会话里加载了包的命名空间，优先使用了已加载的内容，并不是真的找到了已安装的包。

而Vignette运行时是在一个独立的环境里，不会自动帮你执行load_all()，所以自然找不到包。

解决步骤 #

1. 先把开发中的包安装到本地库 #

这是最根本的解决办法，在你的包项目根目录下运行：

devtools::install()

或者用devtools::build_install()（会先构建包再安装，更接近正式发布的流程）。安装完成后，不管是在控制台还是Vignette里，library(mypackage)都能正常运行了。

2. 正确预览/构建Vignette #

如果要预览你的Vignette效果，不要直接在Rmd里逐行运行，而是用devtools提供的专用命令：

# 构建并预览单个vignette
devtools::build_vignettes()
# 或者直接运行包检查（会自动处理vignette的依赖和构建，还能排查其他包问题）
devtools::check()

这些命令会确保在正确的环境中加载已安装的包，避免报错。

3. 开发时的临时小技巧（仅用于开发阶段） #

如果你不想每次修改代码都重新安装包，可以在Vignette的开头加一段判断逻辑，自动检测包是否安装，没安装就临时加载开发版：

# 仅开发阶段使用，正式提交包前请删除这段！
if (!requireNamespace("mypackage", quietly = TRUE)) {
  message("包未安装，临时加载开发版...")
  devtools::load_all(".")
}
library(mypackage)

⚠️ 注意：正式发布包之前，一定要确保包已经安装到本地库，并且把这段临时代码删掉——因为CRAN等仓库要求Vignette依赖的是已安装的正式包，不能依赖开发工具。

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