必须先独立安装R并加入PATH，再安装vscode-R扩展；运行脚本用Ctrl+Enter/Cmd+Enter发送代码，绘图需显式调用或末尾无分号；调试须用browser()或debug()，不支持源码断点。
安装 R 语言支持扩展前先确认 R 是否已正确安装
VS Code 本身不内置 R 运行环境，R 必须在系统中独立安装并加入 PATH。打开终端运行 R --version，若提示“command not found”或路径错误，vscode-R 扩展将无法启动 R session。Windows 用户注意：R 安装时勾选“Add R to system PATH”，macOS 用户若用 brew install r 通常自动配置，但 M1/M2 芯片可能需手动添加 /opt/homebrew/bin 到 shell 配置文件。
推荐使用 vscode-R 而非 R LSP 扩展
vscode-R（作者: Yuki Ueda）目前对 R 脚本编辑、调试、绘图预览支持最稳定；R LSP 扩展依赖 languageserver 包，常因 R 版本更新滞后导致 autocomplete 失效或 R session crashed 错误。安装后需重启 VS Code，并在设置中确认：r.rpath.windows（Windows）、r.rpath.mac（macOS）或 r.rpath.linux 指向正确的 R 可执行文件路径，例如：/usr/local/bin/R 或 C:\Program Files\R\R-4.3.2\bin\R.exe。
运行 R 脚本和内联绘图的关键操作
VS Code 中 R 脚本的执行不是靠“运行按钮”，而是通过快捷键或命令面板触发 R session 交互式执行：
-
Ctrl+Enter（Windows/Linux）或Cmd+Enter（macOS）：发送当前行或选中代码块到 R 终端 -
Ctrl+Shift+Enter：运行整个脚本（等价于source("xxx.R")） - 绘图函数如
plot()、ggplot()默认输出到 VS Code 内置的R Plot面板——但该面板只响应 R session 中显式调用的绘图，不会捕获print(p)中的 ggplot 对象，需改用print(p); dev.flush()或直接写p（末尾无分号） - 若图表不显示，检查 R 终端是否报错
unable to load shared object 'libcairo.so'：Linux 用户需安装系统级依赖，如 Ubuntu 执行sudo apt-get install libcairo2-dev
调试 R 脚本时断点失效的常见原因
VS Code 的 R 调试依赖 debug() 或 browser()，而非图形界面点击断点。直接点击行号左侧设断点无效——vscode-R 当前版本（v2.5.x）**不支持源码级断点调试**。可行方式只有两种：
- 在函数定义开头插入
browser()，运行后进入交互调试模式 - 对已定义函数使用
debug(my_function)，下次调用时自动暂停 - 确保 R session 启动时未启用
--vanilla参数（会禁用 .Rprofile 中的调试配置），可在 VS Code 设置中检查r.termOptions是否包含该参数
可视化调试建议搭配 View(df) 或 str(df) 在 console 中即时查看数据结构，比依赖 IDE 变量面板更可靠。
