VSCode运行R代码需系统已安装R且路径配置正确：检查Rscript是否在PATH中，macOS/Linux需在terminal.integrated.env中添加PATH，Windows需配置R_HOME和PATH；r.rpath必须手动填绝对路径并重启VSCode；绘图需启用GUI后端（如--gui=none）；r.bracketedPasteMode和r.sessionWatcher必须设为true以保障交互稳定。
VSCode 本身不带 R 解释器，运行 R 代码的前提是：系统已装好 R（或 radian），且 VSCode 能准确找到它——路径配错、PATH 没继承、插件没重启，三者任一出问题，Rscript 就会报 command not found。
为什么点“运行当前文件”没反应？先查 Rscript 是否在 PATH 里
这是最常卡住的起点。VSCode 集成终端（尤其是 macOS/Linux）默认不加载你的 shell 配置（如 ~/.zshrc），所以即使终端里能敲 R --version，VSCode 里仍可能找不到 Rscript。
- 在 VSCode 终端里直接运行
which Rscript；如果返回空，说明 PATH 没生效 - macOS/Linux：进设置搜
terminal.integrated.env，添加"PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"（路径按你实际 R 安装位置调整，比如 Homebrew 装的 R 就在/opt/homebrew/bin） - Windows：确认系统环境变量
PATH包含%R_HOME%\bin\x64（或\i386），且R_HOME已设为类似C:\Program Files\R\R-4.3.2 - 改完环境变量后必须**重启 VSCode**——用
code .从旧终端启动无效
r.rpath 必须手动填绝对路径，不能靠 GUI 选
VSCode 的 R 扩展（REditorSupport）不会自动探测 R 位置，GUI 界面里的 “Select R Path” 命令经常失效或只写相对路径，导致后续所有功能（包括调试、绘图、rmarkdown 渲染）都断链。
- 终端里运行
which R或R RHOME，拿到完整路径，例如/opt/homebrew/bin/R（macOS）、C:\Program Files\R\R-4.3.2\bin\R.exe（Windows） - 打开
settings.json（Cmd+Shift+P → Preferences: Open Settings (JSON)），加一行："r.rpath": "/opt/homebrew/bin/R" - 别用
r.rpath.mac或r.rterm.windows这类平台专用键——新版扩展已统一为r.rpath - 填完立刻重启 VSCode，否则扩展仍读缓存路径
绘图不显示？不是插件问题，是 R 终端缺 GUI 支持
VSCode 默认以 console 模式启动 R，plot()、ggplot2 不报错也不出图，因为底层图形设备（quartz / windows / x11）根本没启用。
- 临时方案：在 R 终端里手动运行
options(device = "quartz")（macOS）或options(device = "windows")（Windows），再绘图 - 长期方案：在
settings.json中配置"r.terminalOptions": ["--no-save", "--no-restore", "--quiet", "--gui=none"]，强制启用基础 GUI 后端 - 用
ggplot2时，管道链末尾必须显式print()，否则图对象不渲染（例：ggplot(mtcars) + geom_point() %>% print()） - 若用
httpgd替代传统设备，需额外安装包并设options(device = "httpgd")，但依赖本地 HTTP 服务，调试更重
r.bracketedPasteMode 和 r.sessionWatcher 必须开，否则交互必崩
这两个配置项藏得深，但关掉它们，多行粘贴代码会提前执行、长时间任务无法中断、R 崩溃后 VSCode 彻底失联——不是“功能没做”，而是“功能被禁用了”。
-
r.bracketedPasteMode: true：开启后 VSCode 发送代码时加 POSIX 括号标记，防止含{或换行的代码块被 R 误判为多条命令 -
r.sessionWatcher: true：让 VSCode 持续监听 R 进程状态；关掉后，Ctrl+C中断失败、R 崩溃后 Run Chunk 静默无响应、状态栏 R 图标变灰也不提示 - 两者都需手动加进
settings.json，GUI 设置里没有可靠开关；首次启用r.sessionWatcher时，VSCode 会弹窗要求安装callr包，跳过就 fallback 到不可靠的进程名匹配
真正卡住人的从来不是“怎么装”，而是 PATH 没继承、r.rpath 填了假路径、绘图缺 --gui=none、粘贴代码崩掉还不知道是 r.bracketedPasteMode 关着——这些点不手动核对，装十遍插件也没用。
