R包Vignette中设置引用为Author (year)格式的方法

架构老林

2026-8-31

解决方法

你遇到的格式问题是pandoc引用语法使用不当导致的，不需要额外安装依赖包，按以下方法调整即可：

1. 单处修改正文引用写法（最快生效）

pandoc-citeproc处理引用的默认语法逻辑：

直接书写@引用ID时，渲染输出为作者 (年份)格式，也就是你需要的文内引用效果
给@引用ID外套方括号[@引用ID]时，渲染输出为(作者年份)格式，也就是你当前看到的括号全包裹效果
你当前正文里的引用写的是[@Hall1995] and [@Politis2004]，只需要删掉所有引用外层的方括号，改成如下写法即可：

- @Hall1995 and @Politis2004

改完直接渲染就能得到Hall (1995) and Politis (2004)的预期效果。

2. 全局统一引用格式（可选配置）

如果你需要更精细地控制引用样式（比如调整作者名缩写规则、多作者显示逻辑、引用内标点格式等），可以在YAML头部通过csl字段指定统一的引用样式文件：

先下载对应引用规范的CSL样式文件（比如APA 7th、GB/T 7714等格式文件），放到Vignette文档的同级目录下
在YAML配置块中新增csl字段，示例配置如下：

---
title: "MNP: My New Package"
output: rmarkdown::html_vignette
vignette: >
  %\VignetteIndexEntry{MNP}
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteEncoding{UTF-8}
bibliography: "economia.bib"
csl: "apa-7th-edition.csl" # 替换为你自己使用的CSL文件名
logo: logo.png
---