借助GitHub Cache Action加速R包CI流程的配置求助

针对你的R包CI构建耗时问题，我们可以通过renv管理依赖并结合GitHub Cache Action实现缓存复用，大幅减少依赖安装时间。以下是修改后的完整GitHub Action配置，适配私有包、INLA等特殊依赖场景：

name: R

on:
  push:
    branches: [ "main", "dev" ]
  pull_request:
    branches: [ "main", "dev" ]

permissions:
  contents: read

jobs:
  build:
    runs-on: macos-latest
    strategy:
      matrix:
        r-version: ['4.1.1']
    env:
      GITHUB_PAT: ${{secrets.REPO_KEY}}
      RENV_PATHS_ROOT: ~/.local/share/renv  # 统一renv存储路径，方便缓存
    steps:
      - uses: actions/checkout@v3

      - name: Set up R ${{ matrix.r-version }}
        uses: r-lib/actions/setup-r@f57f1301a053485946083d7a45022b278929a78a
        with:
          r-version: ${{ matrix.r-version }}

      - name: Cache renv dependencies
        uses: actions/cache@v3
        with:
          path: ${{ env.RENV_PATHS_ROOT }}
          key: ${{ runner.os }}-r-${{ matrix.r-version }}-renv-${{ hashFiles('renv.lock') }}
          restore-keys: |
            ${{ runner.os }}-r-${{ matrix.r-version }}-renv-

      - name: Install renv and restore dependencies
        run: |
          # 安装renv
          install.packages("renv", type = "binary")
          
          # 初始化renv（首次运行会生成renv.lock，后续基于lock恢复）
          renv::init(bare = TRUE)
          
          # 恢复依赖：如果缓存存在则直接复用，否则从源安装
          renv::restore(prompt = FALSE)
          
          # 安装INLA（不在CRAN，单独处理）
          if (!requireNamespace("INLA", quietly = TRUE)) {
            install.packages("https://inla.r-inla-download.org/R/stable/src/contrib/INLA_21.02.23.tar.gz", repos = NULL, type = "source")
          }
          
          # 安装rcmdcheck（用于后续检查）
          if (!requireNamespace("rcmdcheck", quietly = TRUE)) {
            install.packages("rcmdcheck", type = "binary")
          }
        shell: Rscript {0}
        
      - name: Check
        run: rcmdcheck::rcmdcheck(args = "--no-manual", error_on = "error")
        shell: Rscript {0}

关键步骤说明 #

1. renv依赖管理

   • renv::init(bare = TRUE)：初始化renv环境，不自动捕获当前依赖（避免干扰现有配置），首次运行后会生成renv.lock文件，该文件记录了所有依赖的版本和来源。
   • renv::restore(prompt = FALSE)：根据renv.lock文件恢复依赖，若缓存存在则直接从缓存加载，跳过下载安装步骤。

2. GitHub缓存配置

   • 缓存路径指向renv的根目录，确保所有依赖包都被缓存。
   • 缓存键包含操作系统、R版本、renv.lock的哈希值：只有当依赖版本、R版本或操作系统变更时，才会重新生成缓存；否则直接复用已有缓存。
   • restore-keys设置降级匹配规则，若当前键无缓存，会尝试匹配同操作系统和R版本的旧缓存，进一步提升缓存命中率。

3. 特殊依赖处理

   • INLA包：通过直接指定安装链接的方式手动安装，避免CRAN源找不到的问题。
   • 私有仓库包：借助环境变量GITHUB_PAT的授权，renv会自动从私有仓库拉取依赖（前提是renv.lock中已正确记录私有包的来源信息）。

使用注意事项 #

• 首次运行Action后，仓库根目录会生成renv.lock文件，需将该文件提交到Git仓库，后续构建才能基于此文件恢复一致的依赖环境。
• 当需要更新依赖时，可在本地运行renv::snapshot()更新renv.lock，再提交到仓库；也可在Action中临时移除prompt = FALSE，手动确认更新。
• 确保secrets.REPO_KEY拥有访问所有私有依赖仓库的权限。

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