在 VS Code 中运行 R
想编写 R 代码,却觉得 RStudio 太重?或者更喜欢 VS Code 的灵活性?把 VS Code 想象成瑞士军刀——一个轻量级编辑器就能处理 R、Python 等多种语言。本教程将教你在 VS Code 中设置 R,获得代码补全、交互式绘图,甚至运行 Shiny 应用。
关键概念
- languageserver - R 包,在 VS Code 中启用代码补全、语法检查和悬停文档
- R Extension - VS Code 扩展,连接编辑器和 R,提供语法高亮、代码执行和调试
- Shiny Extension - VS Code 扩展,用于创建和运行交互式 Shiny Web 应用,支持自动重载
你需要准备的
- 完成 VS Code 基础教程
- 互联网连接以下载 R 和软件包
- 10-15 分钟
步骤 1:安装或更新 R
需要 R 4.0 或更高版本以获得最佳兼容性。
- Windows:
- 从 CRAN Windows 下载最新 R 并运行安装程序
- 安装时,记住安装路径(如:
C:\Program Files\R\R-4.5.3) - 如有旧版本,先通过”设置 > 应用”卸载
- macOS:
- 从 CRAN macOS 下载并运行 .pkg 安装程序
- 记住使用的是 Intel(
/Library/Frameworks/R.framework/Resources/bin/R)还是 Homebrew 的 Apple Silicon(/opt/homebrew/bin/R) - 如是更新,新版本会替换旧版本
- Linux:
- 使用包管理器(如 Ubuntu 上用
sudo apt install r-base) - 或遵循 CRAN Linux 说明
- 使用包管理器(如 Ubuntu 上用
步骤 3 中会配置 VS Code 以找到 R,所以如果 R --version 在终端还不起作用,不必担心。
步骤 2:在 VS Code 中安装 R 扩展
- 打开 VS Code
- 点击左侧边栏的扩展图标
- 搜索
REditorSupport.r,点击 REditorSupport 的 R 扩展上的安装 - 搜索
Posit.shiny,点击 Posit 的 Shiny 扩展上的安装
步骤 3:查找你的 R 安装路径
配置 VS Code 前,需要知道 R 安装在系统的什么位置。
Windows 用户
- 打开文件资源管理器
- 导航至
C:\Program Files\R\ - 会看到类似
R-4.5.3的文件夹(你的版本号可能不同) - 打开该文件夹 → 打开
bin文件夹 - 会看到
R.exe - 完整路径为:
C:\Program Files\R\R-4.5.3\bin\R.exe
记住版本号(如 R-4.5.3)——步骤 4 需要用到。
macOS 用户
R 安装通常位于以下位置之一:
- 标准安装(Intel 或 Apple Silicon):
/Library/Frameworks/R.framework/Resources/bin/R - Apple Silicon 上的 Homebrew:
/opt/homebrew/bin/R - Intel 上的 Homebrew:
/usr/local/bin/R
验证路径,打开终端并输入:
which R
会显示 R 安装的确切路径。
Linux 用户
R 通常安装在:/usr/bin/R
打开终端,输入以下命令验证:
which R
步骤 4:配置 VS Code 以找到 R
- VS Code 中,点击左下角的齿轮图标
- 从菜单选择设置
- 在顶部搜索栏,输入
r.rpath.windows(Windows)、r.rpath.mac(macOS)或r.rpath.linux(Linux) - 会看到该设置出现。点击设置下方的在 settings.json 中编辑
- settings.json 文件会打开
- 在花括号
{}内为你的平台添加相应配置
对于 Windows,添加此行(将 R-4.5.3 替换为你在步骤 3 中的版本):
"r.rpath.windows": "C:\\Program Files\\R\\R-4.5.3\\bin\\R.exe",
为什么用两个反斜杠(\\)? 在 JSON 文件中,反斜杠 \ 是特殊字符(称为转义字符)。要在实际文件路径中表示单个反斜杠,必须输入两个反斜杠 \\。因此,C:\Program Files 在 settings.json 中变成 C:\\Program Files。
对于 macOS,添加以下行之一:
"r.rpath.mac": "/Library/Frameworks/R.framework/Resources/bin/R",
或者,如果在 Apple Silicon 上通过 Homebrew 安装 R:
"r.rpath.mac": "/opt/homebrew/bin/R",
对于 Linux,添加:
"r.rpath.linux": "/usr/bin/R",
- 点击文件 > 保存保存文件
- 完全重启 VS Code 以使更改生效
步骤 5:安装所需的 R 包
- VS Code 中,点击顶部菜单的查看,然后选择命令面板
- 输入
R: Create R Terminal并选择 - R 控制台会出现在底部终端面板
- 应该会看到 R 启动并显示版本信息
- 如出现错误,仔细检查步骤 4 中的 settings.json 配置并重启 VS Code
- 逐个输入以下命令安装包:
install.packages("languageserver")
install.packages("shiny")
- 等待安装完成(可能需要几分钟)
- 输入
q()并按 Enter 退出 R - 询问是否保存工作空间时,输入
n
仅在常规终端输入 R 不起作用,除非 R 在系统 PATH 中。R 扩展使用 r.rpath 设置找到 R。
步骤 6:创建你的 R 项目
- 在计算机上创建新文件夹(如
my-r-project) - VS Code 中,点击文件 > 打开文件夹选择你的新文件夹
- 点击顶部菜单的文件 > 新建文件
- 点击文件 > 保存将文件保存为
analysis.R
步骤 7:编写你的第一个 R 脚本
- 在
analysis.R中输入以下代码:
# Load the iris dataset
data(iris)
# View the first few rows
head(iris)
# Generate summary statistics
summary(iris)
hist(iris$Sepal.Length)
- 点击文件 > 保存保存文件
步骤 8:交互式运行 R 代码
- 打开
analysis.R,选择一行代码,按Ctrl+Enter(Windows/Linux)或Cmd+Enter(Mac)运行 - 如果没有打开终端,第一次
Ctrl+Enter/Cmd+Enter会打开 R 终端。第二次会运行代码。 - 输出会出现在终端,图形会在单独窗口打开
- 也可以选择所有行,用相同方式运行
步骤 9:创建一个简单的 Shiny 应用
- 在项目文件夹创建新文件:文件 > 新建文件
- 保存为
app.R - 输入以下代码:
library(shiny)
ui <- fluidPage(
titlePanel("Interactive Histogram"),
sidebarLayout(
sidebarPanel(
sliderInput("bins",
"Number of bins:",
min = 5,
max = 50,
value = 30)
),
mainPanel(
plotOutput("histogram")
)
)
)
server <- function(input, output) {
output$histogram <- renderPlot({
x <- faithful$waiting
bins <- seq(min(x), max(x), length.out = input$bins + 1)
hist(x, breaks = bins, col = "steelblue", border = "white",
xlab = "Waiting time (minutes)",
main = "Distribution of Waiting Times")
})
}
shinyApp(ui = ui, server = server)
- 保存文件
- 注意编辑器右上角出现的 ▶ 按钮
- 点击下拉菜单选择 Run Shiny App
- 应用会在浏览器或 VS Code 面板打开
- 移动滑块,观察直方图即时更新
步骤 10:使用代码补全和悬停帮助
- 在
analysis.R新行开始输入mea - 会出现带建议的下拉菜单——按 Enter 选择
mean() - 鼠标悬停在现有代码中的单词
mean上 - 会出现弹出窗口,显示函数文档和使用示例
- 尝试悬停在
lm、summary或plot上查看文档 - 输入
data$,观察 VS Code 建议列名(x和y)
步骤 11:尝试更多功能
- Markdown 集成:创建 R Markdown 文件(
.Rmd)以混合代码、输出和文本 - 代码格式化:在 R 脚本中右键选择格式化文档以自动格式化代码
- 调试:点击行号左侧设置断点,然后在调试模式下运行代码
- Git 集成:使用 VS Code 内置 Git 功能对 R 项目进行版本控制
下一步
- 创建包含单独
ui.R和server.R文件的多文件 Shiny 应用 - 探索 ggplot2 进行高级数据可视化
- 尝试 tidyverse 包(
dplyr、tidyr)进行数据操作 - 学习 R Markdown 或 Quarto 创建嵌入 R 代码的报告
- 安装 R Debugger 扩展进行高级调试
故障排除
- VS Code 终端中”无法识别 R”:VS Code 找不到 R。检查 settings.json(步骤 4)——验证 R 路径是否正确并指向
R.exe(Windows)或 R 二进制文件(Mac/Linux)。示例路径:- Windows:
C:\\Program Files\\R\\R-4.5.3\\bin\\R.exe(调整版本号) - macOS Intel:
/Library/Frameworks/R.framework/Resources/bin/R - macOS Homebrew:
/opt/homebrew/bin/R - Linux:
/usr/bin/R修复后,完全重启 VS Code。
- Windows:
-
settings 中的 R 版本不匹配:如果更新了 R 但 VS Code 仍在使用旧版本,更新 settings.json 中
r.rpath配置的版本号以匹配新 R 安装(参见步骤 3 找到当前安装路径)。 -
代码补全不起作用:确保 languageserver 已成功安装(步骤 5)。安装后重启 VS Code。打开 R 文件后等 10-20 秒让语言服务器初始化。检查输出面板(查看 > 输出 > R Language Server)中的错误。
-
图形未显示:图形会使用 R 默认图形设备在单独窗口打开。确保有可用的窗口管理器。某些系统上,可能需要安装 X11(macOS)或确保启用了图形支持。
- Shiny 应用无法运行:确保已安装 Shiny 扩展(步骤 2)、已安装 shiny 包(步骤 5)且文件名为
app.R。检查终端错误消息。仅当 VS Code 将文件识别为 Shiny 应用时,运行按钮才会出现。
工作流程总结
VS Code 提供 RStudio 的现代、轻量级替代方案,主要优势:
- 统一环境:一个编辑器编写 R、Python、JavaScript 等代码
- 可定制:仅安装需要的扩展,实现精简设置
- 集成终端:并排运行 R、Git 和 shell 命令
- Shiny 开发:一键启动应用并自动重载,节省时间
- 版本控制:内置 Git 集成,无需外部工具
由 Steven Ge 创建于 2025 年 12 月 7 日。