ITADN
rstudio/renv
代码 动态 Issues614 合并请求322 版本17
rstudio/renv · 文件 下载 ZIP
文件最后提交记录最后更新时间
README.md
以下内容由 AI 翻译，如有问题请点此提交 issue 反馈

renv

Lifecycle: stable CRAN status R-CMD-check

概述

renv 软件包1 可帮助您为 R 项目创建可重复的环境。使用 renv 使您的 R 项目更加独立、可移植且可重复。

  • 独立：为一个项目安装新的或更新的软件包 不会破坏您的其他项目，反之亦然。这是因为 renv 为每个项目提供其自己的私有库。
  • 可移植：轻松地将您的项目从一台计算机 传输到另一台计算机，甚至跨越不同的平台。renv 使安装 您的项目所依赖的软件包变得容易。
  • 可重复：renv 记录您依赖的 确切软件包版本，并确保这些确切版本在任何地方 都是被安装的版本。

安装

使用以下命令从 CRAN 安装 renv 的最新版本：

install.packages("renv")

或者，从 r-universe 安装开发版本：

install.packages("renv", repos = "https://rstudio.r-universe.dev")

工作流程

A diagram showing the most important verbs and nouns of renv. Projects start with init(), which creates a project library using packages from the system library. snapshot() updates the lockfile using the packages installed in the project library, where restore() installs packages into the project library using the metadata from the lockfile, and status() compares the lockfile to the project library. You install and update packages from CRAN and GitHub using install() and update(), but because you'll need to do this for multiple projects, renv uses cache to make this fast.

使用 renv::init() 在新项目或现有项目中初始化 renv。这 将设置一个 项目库，包含你当前正在使用的 所有包。这些包（以及重新安装它们所需的所有元数据） 会被记录到一个 锁文件 中，renv.lock，并且一个 .Rprofile 确保每次打开该项目时都会使用该库。

随着你继续开发项目，你将安装和升级 包，可以使用 install.packages() 和 update.packages() 或 renv::install() 和 renv::update()。在你确认代码 按预期工作后，使用 renv::snapshot() 将包及其 来源记录到锁文件中。

稍后，如果你需要与他人分享代码或在新机器上运行代码， 你的协作者（或你自己）可以调用 renv::restore() 来 重新安装锁文件中记录的特定包版本。

了解更多

如果您第一次使用 renv，我们强烈建议从 renv 入门] 小册子开始： 这将帮助您理解 renv 中最重要的动词和名词。

如果您对 renv 有疑问，请先查看 FAQ] 以确认 您的问题是否已有解答。如果没有，请随时 在 Posit Forum] 上提问。

如果您认为在 renv 中发现了一个 bug，请在 https://github.com/rstudio/renv/issues 提交 bug（如果 可能，请附上 可复现示例]）。

Footnotes

  1. 发音为 “R” “env” ↩