VSCode运行R代码需本地安装R或radian并正确配置PATH和环境变量；macOS/Linux需在terminal.integrated.env中设置PATH，Windows需配置R_HOME和PATH；r.rterm.path设为radian或Rscript，r.bracketedPasteMode和r.sessionWatcher必须启用以保障粘贴与调试功能。
VSCode 本身不带 R 解释器，运行 R 代码必须依赖你本地已安装的 R 或 radian，且 VSCode 必须能“找到”它——绝大多数运行失败（比如点击运行没反应、终端报 command not found: Rscript）都卡在这一步。
VSCode 找不到 R 或 radian：PATH 和环境变量是核心瓶颈
macOS/Linux 下 VSCode 的集成终端默认不加载你的 shell 配置（如 ~/.zshrc），所以即使你在终端里能跑 Rscript --version，VSCode 里可能就报错。Windows 则常见 R_HOME 没设或 %R_HOME%\bin\x64 没进系统 PATH。
- macOS/Linux：打开 VSCode 设置，搜
terminal.integrated.env，添加键值对"PATH": "/usr/local/bin:/opt/homebrew/bin:${env:PATH}"（路径按你实际which Rscript输出调整） - Windows：确认系统环境变量中已设置
R_HOME（如C:\Program Files\R\R-4.3.2），并把%R_HOME%\bin\x64加入PATH；改完后必须彻底退出 VSCode（右上角 × 关闭所有窗口），再重新双击图标启动 - 验证方式：在 VSCode 集成终端里直接运行
which Rscript或where radian，有输出才代表路径生效
r.rterm.path 设成 radian 还是 R？取决于你想要什么交互体验
radian 是 Python 写的增强型 R REPL，支持多行粘贴、语法高亮、自动补全；原生 R 启动快但交互简陋。VSCode 的 R 插件默认调用 R，想换 radian 要手动指定路径，且必须关掉不兼容参数。
- 先确保已执行
pip install radian，并在终端输入radian能正常进入 REPL - VSCode 设置中搜
r.rterm.path，填radian（不是完整路径，插件会自动在PATH中查找） - 同时搜
r.rterm.option，删掉--no-save和--no-restore（radian不认这两个参数，留着会导致启动失败） - 如果只图稳定、不介意交互简陋，填
R或Rscript也完全可行，但务必确认它们在PATH中可访问
r.bracketedPasteMode 和 r.sessionWatcher 不开，粘贴和调试大概率翻车
这两个配置项藏得深，但直接影响真实工作流：不开 r.bracketedPasteMode，从网页复制一段含 { 或换行的 ggplot 代码，一粘贴就触发部分执行；不开 r.sessionWatcher，跑一个 lm() 拟合半小时，中途想 Ctrl+C 中断，发现按钮灰了、进程无响应——其实插件早就“失联”了。
-
r.bracketedPasteMode：设为true，才能安全粘贴多行代码 -
r.sessionWatcher：设为true，插件才通过callr包监听 R 进程状态；首次启用时 VSCode 会提示安装callr，必须点“是”，否则 fallback 到不可靠的进程名匹配 - 二者都依赖底层 R 包支持，不是纯前端开关；若启用后仍异常，先在 R 控制台运行
library(callr); library(languageserver)确认无报错
R Markdown 和绘图预览要额外扩展和配置
R 插件本身不处理 .Rmd 渲染或图形显示，需要组合扩展和设置才能复现 RStudio 级体验。
- 装
R Markdown扩展（作者 Yuki Ueda），右键.Rmd文件选R Markdown: Preview启动 HTML 预览 - 绘图需开启
r.plotViewer（设为true），否则图形只打在终端或弹出独立窗口；同时建议在 R 启动时清空设备栈，避免旧图残留，可在.Rprofile加graphics::dev.off(); grDevices::dev.list() - 如果用
httpgd替代传统设备（推荐），需额外install.packages("httpgd")，并确保r.plotViewer开启，它会自动接管绘图输出
最易被忽略的其实是环境变量生效时机：改完 PATH 或 R_HOME 后，VSCode 必须冷重启（不是 Reload Window），否则所有路径配置都是纸面功夫。另外，radian 依赖 Python，但 VSCode 的 R 插件和 Python 插件存在冲突风险——混用 reticulate 时，建议关掉 Python 插件的自动解释器检测，并设 r.terminal.executeInRConsole 为 true。
