GitHub Actions中用actions/checkout后renv无法调用R库的问题

我在GitHub Actions上运行{targets}流水线，依赖由renv管理，整个流程基于Docker容器运行。为缩短运行耗时，构建Docker镜像时已通过renv预构建了R库，但流水线代码在运行时通过checkout拉取。

核心问题：checkout前运行R代码，renv可正常识别预构建库；checkout之后，renv找不到预构建的库，必须重新安装所有包。

Dockerfile #

FROM rocker/verse:4.3.0

ENV RENV_VERSION 0.17.3
RUN R -e "install.packages('remotes', repos = c(CRAN = 'https://cloud.r-project.org'))"
RUN R -e "remotes::install_github('rstudio/renv@${RENV_VERSION}')"

WORKDIR /project
COPY renv.lock renv.lock

ENV RENV_PATHS_LIBRARY renv/library

RUN R -e "renv::restore()"

GitHub Workflow #

on:
  push:
    branches:
      - main
      - master
  pull_request:
    branches:
      - main
      - master
  schedule:
    - cron: '0 13 * * 0,2,4'

name: targets

jobs:
  targets:
    runs-on: ubuntu-latest
    container:
      image: (上述镜像)
    env:
      GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
      LANG: en_US.UTF-8 
    steps:      
      - name: 测试checkout前renv是否正常
        shell: Rscript {0}
        run: renv::restore() # 正常工作 - 与lock文件同步

      - uses: actions/checkout@v3

      - name: 测试checkout后renv是否正常
        shell: Rscript {0}
        run: renv::restore() # 失效 - 从lock文件重新安装库

问题分析 #

最初猜测是checkout改变了工作目录，但测试后确认目录未变化。实际原因是checkout后项目中的activate.R文件覆盖了renv配置：checkout前没有触发renv引导流程，checkout后activate.R生效，修改了库路径配置，导致预构建的库无法被识别。

解决方案 #

方案1：Dockerfile中预激活renv #

在Dockerfile完成renv::restore()后，运行renv::activate()，让容器中的renv环境与后续checkout的项目激活脚本保持一致：

# ... 原Dockerfile内容 ...
RUN R -e "renv::restore()"
# 添加激活命令
RUN R -e "renv::activate()"

同时确保Dockerfile中设置的RENV_PATHS_LIBRARY与项目.Rprofile或activate.R中的路径完全匹配。

方案2：checkout后显式指定库路径 #

在checkout后的步骤中，手动设置RENV_PATHS_LIBRARY环境变量，避免activate.R覆盖配置：

- name: 测试checkout后renv是否正常
  shell: Rscript {0}
  run: |
    Sys.setenv(RENV_PATHS_LIBRARY = "renv/library")
    renv::restore()

方案3：确保checkout路径与容器工作目录一致 #

虽然容器默认WORKDIR是/project，仍可显式指定checkout路径，避免路径不匹配：

- uses: actions/checkout@v3
  with:
    path: /project

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