VSCode R插件新增章节标题后大纲视图消失问题求助

问题描述 #

使用REditorSupport的vscode-R插件多年，此前大纲视图可正常显示函数、章节等符号。当前遇到异常：打开R脚本时大纲显示正常，但新增章节标题（如# Testing ----）或代码后，大纲视图消失并提示No symbols found in document，插件日志显示[2025-03-24 10:24:21.630] document definitions found: 0，仅能通过关闭并重新打开文件临时恢复大纲。

复现步骤 #

• 打开包含函数和章节标题（# Section name ----）的R脚本
• 确认大纲视图正常显示所有符号
• 添加新章节标题（如输入# Testing ----）
• 观察到大纲视图切换为No symbols found in document
• 关闭并重新打开文件可临时恢复大纲显示

已尝试方案 #

• 重装vscode-R插件
• 重装R语言的languageserver包
• 调整语言服务器相关配置
• 其他文件类型（如Python）的大纲视图正常，仅R文件出现该问题

期望行为 #

编辑文件或新增章节标题后，大纲视图能持续正常显示所有符号

环境信息 #

• 操作系统：macOS
• VSCode版本：1.98.2
• R版本：4.4.3
• vscode-R版本：2.8.4

当前settings.json配置 #

{
  "files.autoSave": "off",
  "terminal.integrated.inheritEnv": false,
  "explorer.autoReveal": false,
  "git.autofetch": true,
  "r.plot.useHttpgd": false,
  // "r.rterm.mac": "/opt/homebrew/bin/R",
  "r.rterm.mac": "/my/radian/path", // note that this is different than r.rterm.mac
  "r.bracketedPaste": true,
  "r.rterm.option": ["--no-save", "--no-restore"],
  "terminal.integrated.env.osx": {
    "R_HOME": "/opt/homebrew/Cellar/r/4.4.3/lib/R"
  },
  "r.rpath.mac": "/opt/homebrew/bin/R",
  "files.exclude": {
    "**/.gitattributes": true,
    "**/.gitignore": true,
    "**/.vscode": true
  },
  "settingsSync.ignoredExtensions": [],
  "workbench.editor.openSideBySideDirection": "right",
  "git.enableSmartCommit": true,
  "git.confirmSync": false,
  "editor.minimap.showSlider": "always",
  "editor.find.autoFindInSelection": "always",
  "git.postCommitCommand": "sync",
  "git.showPushSuccessNotification": true,
  "outline.collapseItems": "alwaysCollapse",
  "r.alwaysUseActiveTerminal": true,
  "notebook.editorOptionsCustomizations": {},
  "notebook.output.scrolling": "force inline",
  "terminal.integrated.shellIntegration.suggestEnabled": true,
  "github.copilot.editor.enableAutoCompletions": true,
  "terminal.integrated.profiles.osx": {
    "bash": {
      "path": "bash",
      "args": ["-l"],
      "icon": "terminal-bash"
    },
    "zsh": {
      "path": "zsh",
      "args": ["-l"]
    },
    "fish": {
      "path": "fish",
      "args": ["-l"]
    },
    "tmux": {
      "path": "tmux",
      "icon": "terminal-tmux"
    },
    "pwsh": {
      "path": "pwsh",
      "icon": "terminal-powershell"
    }
  },
  "terminal.integrated.defaultProfile.osx": "zsh",
  "interactiveWindow.executeWithShiftEnter": true,
  "jupyter.interactiveWindow.textEditor.executeSelection": true,
  "python.terminal.executeInFileDir": true,
  "python.dataScience.sendSelectionToInteractiveWindow": true,
  "python.dataScience.showCellInputCode": false,
  "python.dataScience.textOutputLimit": 500,
  "python.dataScience.notebookFileRoot": "${workspaceFolder}",
  "macros": {
    "runAndMoveCursor": [
      "python.execSelectionInInteractiveWindow",
      "cursorMove"
    ]
  },
  "workbench.editor.splitInGroupLayout": "vertical",
  "r.session.viewers.viewColumn": {
    "view": "Active",
    "plot": "Active",
    "viewer": "Active"
  },
  "workbench.editorAssociations": {
    "*.csv": "gc-excelviewer-csv-editor"
  },
  "editor.codeActionsOnSave": {
    "source.fixAll": "never"
  },
  "editor.formatOnSave": false,
  "editor.formatOnType": false,
  "r.linting.enabled": false,
  "python.linting.enabled": false,
  "eslint.enable": false,
  "r.lsp.enabled": true,
  "r.lsp.diagnostics": true,
  "r.lsp.debug": true,
  "r.sessionWatcher": true,
  "files.associations": {
    "*.rmd": "markdown"
  },
  "workbench.secondarySideBar.showLabels": false
}

排查与解决步骤 #

1. 切换符号解析模式
   在settings.json中添加或修改以下配置，回退到插件内置的符号解析逻辑，跳过LSP实时解析：

   "r.lsp.documentSymbols": false
   

2. 验证并更新语言服务器版本
   打开R终端执行以下命令检查languageserver版本：

   packageVersion("languageserver")
   

   若版本低于0.3.20，执行更新：

   install.packages("languageserver")
   

3. 清理插件缓存

   • 关闭VS Code
   • 删除插件缓存目录：

     ~/.vscode/extensions/reditorsupport.r-2.8.4/server
     

   • 重新启动VS Code并打开R文件

4. 调整文件同步设置
   修改自动保存模式，避免编辑时文件状态异常：

   "files.autoSave": "afterDelay"
   

   同时禁用会话监控，防止干扰符号解析：

   "r.sessionWatcher": false
   

5. 统一章节标题格式
   确保新增章节标题格式规范，避免多余空格或错误分隔符：

   • 正确格式：# Testing ----
   • 避免：# Testing ----（前后多余空格）或# Testing====（分隔符错误）

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