sublime text 需调用系统已安装的 rscript 才能运行 r 脚本,配置核心是确保 rscript 路径正确并被 sublime 找到;需先验证终端中 rscript --version 是否可用,再通过 r-box 插件实现语法高亮与自定义 sublime-build 文件指定 rscript 绝对路径及环境变量,最后重启 sublime 生效。

Sublime Text 本身不内置 R 支持,也不能直接运行 R 脚本——它只是一个编辑器。真正能“运行 R”的是系统里已安装的 R 或 Rscript 命令行工具;Sublime 只负责调用它。所以配置的核心不是“让 Sublime 懂 R”,而是“让 Sublime 正确找到并调用你的 R 安装”。
确认本地 R 是否可用且路径正确
这是最关键的前置条件。如果终端里连 Rscript --version 都报 command not found,后续所有配置都无效。
- macOS/Linux:在终端执行
which Rscript,典型输出类似/usr/local/bin/Rscript或/opt/homebrew/bin/Rscript - Windows:打开命令提示符,运行
where Rscript,常见路径如C:Program FilesRR-4.3.2inRscript.exe - 如果找不到,说明 R 没装好,或没加进系统 PATH —— 不要跳过这步去配 Sublime
安装 Sublime 的 R 语法支持和构建系统
语法高亮靠 Package Control 安装插件,运行脚本靠自定义 sublime-build 文件。两者缺一不可。
- 用
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)打开命令面板,输入Install Package回车,再搜R-Box并安装(比旧版 “R” 插件更活跃、支持新语法) - 安装后,新建文件 →
Ctrl+Shift+P→ 输入Set Syntax: R,即可启用语法高亮 - R-Box 默认自带构建系统,但可能指向错误的
Rscript路径——需要手动检查或覆盖
手动配置 R 构建系统(避免“Rscript not found”错误)
很多用户卡在这一步:点了 Ctrl+B 却弹出 Unable to find Rscript 或空窗口闪退。根本原因是 Sublime 找不到 Rscript,尤其 macOS 和 Windows 上 PATH 环境变量与 GUI 应用不一致。
- 菜单栏 →
Tools→Build System→New Build System… - 替换全部内容为以下(按你实际路径修改
cmd中的Rscript路径):
{
"cmd": ["Rscript", "$file"],
"selector": "source.r",
"working_dir": "$file_path",
"env": {"PATH": "/usr/local/bin:/opt/homebrew/bin:$PATH"}
}
⚠️ 注意:env 字段只对 macOS/Linux 有效;Windows 用户应删掉 env 行,并确保 cmd 中路径是绝对路径,例如:
"cmd": ["C:\Program Files\R\R-4.3.2\bin\Rscript.exe", "$file"]
- 保存为
Rsublime.sublime-build(文件名任意,但后缀必须是.sublime-build) - 之后在
Tools → Build System里选中它,再按Ctrl+B就能运行当前 R 脚本了
运行结果输出位置与调试建议
Sublime 的构建输出默认显示在底部面板,但它不支持交互式 R 控制台(比如不能输 plot(1:10) 后再点图窗)。所有输出都是单次批处理结果。
- 图形设备(如
plot())默认不会弹窗——因为Rscript是无界面模式。想看图?改用png()+dev.off()保存文件,或换用Rterm构建系统(需额外配置) - 报错信息如果太短,可在构建文件里加
"cmd": ["Rscript", "--vanilla", "$file"],禁用用户配置减少干扰 - 中文乱码常见于 Windows,默认编码不是 UTF-8。可在构建系统中加
"encoding": "UTF-8",并确保 R 脚本文件本身也存为 UTF-8(无 BOM)
最易被忽略的一点:Sublime 的构建系统不会自动重载环境变量变更。改完系统 PATH 后,必须完全退出 Sublime 再重启,否则仍找不到 Rscript。











