使用R Markdown编织时触发xfun包参数未使用错误

问题详情 #

更新RStudio及所有包后，卸载重装xfun包仍无法编织默认R Markdown，报错信息如下：

Error in xfun::normalize_path(path, ..., must_work = must_work, resolve_symlink = FALSE) :
unused argument (resolve_symlink = FALSE)
Calls: -> normalize_path
Execution halted

已加载的命名空间包包含xfun_0.30、rmarkdown_2.20、knitr_1.39等。

解决思路 #

• 修复包版本兼容性
  报错核心是当前xfun_0.30版本的normalize_path函数没有resolve_symlink参数，但调用它的包（如rmarkdown/knitr）仍在使用该参数，说明版本不匹配。可尝试：

  1. 安装xfun最新版本：

     install.packages("xfun", type = "binary")
     

  2. 若最新版仍有问题，回退到适配当前rmarkdown/knitr的xfun版本（resolve_symlink参数在xfun_0.39及以上版本中添加）。

• 强制更新核心依赖包
  确保rmarkdown、knitr等编织核心包为最新版，避免旧版本调用过时参数：

  update.packages(c("rmarkdown", "knitr", "xfun"), dependencies = TRUE)
  

• 清理缓存后重装包
  缓存可能导致版本冲突，按以下步骤操作：

  1. 卸载冲突包：

     remove.packages(c("xfun", "rmarkdown", "knitr"))
     

  2. 手动删除R包目录中对应的包文件夹（Windows路径：C:\Users\[用户名]\AppData\Local\R\win-library\[R版本]；Mac路径：~/Library/R/[R版本]/library）。
  3. 重新安装包：

     install.packages(c("xfun", "rmarkdown", "knitr"))
     

• 更新R版本
  当前使用的R 4.0.3版本较旧，部分新包特性需要更高版本R支持。建议更新到最新稳定版（如4.3.x）后，重新安装所有包，从根源避免版本兼容问题。

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