VSCode中Jupyter R内核首字符串被lintr标红报错如何解决

报错场景 #

完成VSCode环境下R与Jupyter Notebook适配配置后，lintr会将R内核中的首个字符串标记为红色，触发如下报错：

Failed to run diagnostics: ! error in callr subprocess
Caused by error:
! Full file exclusions must be character vectors of length 1. items: 1 are not! lintr

卸载languageserver包后异常提示会消失，但VSCode会自动提示重新安装该包，重装完成后问题复现。

根因说明 #

这是旧版本lintr与VSCode R插件、Jupyter Notebook交互时的参数兼容bug：Jupyter场景下传递给lintr的临时文件排除路径被错误解析为数值类型，不符合lintr要求的「长度为1的字符向量」的参数校验规则，直接触发诊断进程崩溃。

修复步骤 #

按顺序操作即可彻底解决问题，不需要卸载languageserver：

• 升级lintr到官方最新版本，打开R控制台执行：
  install.packages("lintr")
  最新版lintr已经修复了非字符型排除参数的兼容逻辑，适配Jupyter临时文件的传参格式，绝大多数场景升级后直接重启服务即可恢复正常。
• 如果升级后仍存在报错，手动配置用户级lintr规则：
  • 打开R控制台执行file.edit("~/.lintr")，创建/编辑用户根目录下的lintr配置文件
  • 写入如下配置，确保排除规则格式符合要求：

    linters: linters_with_defaults()
    exclusions: list(
      "*jupyter*" = TRUE,
      "*ipynb_checkpoints*" = TRUE
    )
    

  • 保存文件后关闭。
• 重启R语言服务生效：在VSCode中按快捷键调出命令面板（Windows/Linux按Ctrl+Shift+P，macOS按Cmd+Shift+P），搜索并执行R: Restart R Language Server即可。
• 可选方案：如果不需要在Jupyter Notebook中启用lintr诊断，可以直接打开VSCode设置，搜索r.lintr.enabled，将Notebook场景下的lintr开关单独关闭，不会影响普通.R脚本的代码检查功能。

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