如何在渲染RMarkdown/Quarto文件为PDF时实现自动增量版本控制？

问题核心 #

• YAML头部的version字段并非原生支持的元数据，无法被自动识别处理
• 你之前的自定义函数未生效，大概率是执行时机不对、缓存路径未提前创建，或是渲染时触发了内容缓存导致函数未重新执行

可行解决方案 #

方案1：通用R脚本实现（适配RMarkdown/Quarto） #

步骤1：修正版本控制函数

调整函数逻辑，确保缓存目录自动创建，同时可灵活控制版本递增步长：

# 自动增量版本函数
get_auto_version <- function() {
  cache_dir <- "./.version_cache"
  cache_file <- file.path(cache_dir, "version.RData")
  
  # 自动创建缓存目录
  dir.create(cache_dir, recursive = TRUE, showWarnings = FALSE)
  
  if (!file.exists(cache_file)) {
    current_ver <- 1.0
  } else {
    load(cache_file)
    current_ver <- current_ver + 0.1 # 改为1.0可实现大版本递增（如1.0→2.0）
  }
  
  # 保存更新后的版本
  save(current_ver, file = cache_file)
  return(paste0("v", sprintf("%.1f", current_ver)))
}

# 获取当前版本
doc_version <- get_auto_version()

步骤2：在文档中注入版本

• YAML头部引用（通过params传递，RMarkdown和Quarto均支持）：

  ---
  title: "Project: Example"
  date: "April 2024"
  documentclass: report
  params:
    version: !r get_auto_version()
  ---
  

• 正文显示版本：

  当前版本：*`r params$version`*
  

步骤3：确保渲染时执行函数

在VSCode中，确认R工作目录为当前文档所在目录（可通过底部状态栏切换），同时关闭内容缓存：

• RMarkdown：在代码块设置cache: false
• Quarto：在YAML中添加execute: cache: false

方案2：Quarto极简实现 #

Quarto支持在YAML中直接嵌入R逻辑，可简化流程：

---
title: "Project: Example"
date: "April 2024"
format:
  pdf:
    documentclass: report
execute:
  cache: false
  echo: false
---

```{r}
get_auto_version <- function() {
  cache_file <- "./.version_cache.RData"
  if (!file.exists(cache_file)) {
    current_ver <- 1.0
  } else {
    load(cache_file)
    current_ver <- current_ver + 0.1
  }
  save(current_ver, file = cache_file)
  return(paste0("v", sprintf("%.1f", current_ver)))
}
doc_version <- get_auto_version()

文档版本：r doc_version

## 排查要点
- 若版本未递增：检查缓存文件是否存在，确认渲染时未触发内容缓存
- 若函数报错：确认工作目录权限正常，缓存文件未被锁定

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