Sublime Text 本身并不具备运行R脚本的能力。它既没有内置R解释器，也没有默认的构建系统。

所谓的“配置成功”，本质上是让它能够正确调用你系统中已经安装好的Rscript或R命令。

这一步如果没走通，后续的一切操作，包括快捷键、图形输出、包加载，都无从谈起。

那么，要迈过这道门槛，关键在于以下几个环节。

确认 Rscript 在终端能直接调用

这是90%的Unable to find command 'Rscript'错误的根源所在。

Sublime Text并不继承shell的用户配置文件，比如.zshrc。因此，即便你在终端里输入Rscript --version有输出，Sublime还是可能找不到它。

• macOS/Linux：在终端运行which Rscript。如果没有输出，说明Rscript没有被添加到PATH环境变量中。通过Homebrew安装的R，其路径通常位于/opt/homebrew/bin/Rscript或/usr/local/bin/Rscript。
• Windows：打开命令提示符，运行where Rscript。常见路径类似C:Program FilesRR-4.3.2binRscript.exe。请注意，版本号需要替换为你实际安装的版本。
• 务必注意：Sublime Text无法识别RStudio自带的内部R副本。它必须依赖于你独立安装的R环境。
• 一个可靠的验证方法是：从终端启动Sublime Text。macOS/Linux执行subl .；Windows在命令提示符下执行subl。然后再尝试按下Ctrl+B进行构建。

编写一个可靠的 .sublime-build 文件

Build System是Sublime调用外部命令的唯一可控入口。

过多依赖插件封装，反而可能掩盖路径问题。直接编写JSON格式的构建文件，是最稳定可靠的方案。

• 操作路径：菜单栏 → Tools → Build System → New Build System…
• 根据你的操作系统，粘贴以下内容：

macOS（Homebrew安装）

{
  "cmd": ["Rscript", "$file"],
  "selector": "source.r",
  "working_dir": "$file_path",
  "env": {"PATH": "/opt/homebrew/bin:/usr/local/bin:$PATH"}
}

Windows（路径包含空格，必须用双引号包裹）

{
  "cmd": ["C:Program FilesRR-4.3.2binRscript.exe", "$file"],
  "selector": "source.r",
  "working_dir": "$file_path"
}

• $file代表当前文件的完整路径，$file_path则表示其所在目录。这能确保你的R脚本可以正确读取同一目录下的CSV或RData文件。
• 在Windows路径中，反斜杠必须双写（），单写会被JSON解析为转义字符。
• 不建议添加"shell": true。在Windows上，这会导致窗口一闪而过；在macOS/Linux上，则可能干扰编码处理。

安装 R-Box 插件并正确设置 r_binary

R-Box 是目前唯一持续维护且兼容Sublime Text 4的R插件。

它提供了语法高亮、代码片段，以及通过Ctrl+Enter将代码块发送到R控制台的能力。但它默认只查找固定路径，不会自动适配你的R安装位置。

• 通过Package Control安装R-Box，然后重启Sublime Text。
• 打开任一.R文件，检查右下角是否显示R。如果显示Plain text，按Ctrl+Shift+P，输入Set Syntax: R手动绑定。
• 进入菜单栏 → Preferences → Package Settings → R-Box → Settings，在右侧的用户设置中添加以下内容：

macOS

"r_binary": "/opt/homebrew/bin/R"

Windows

"r_binary": "C:Program FilesRR-4.3.2binx64R.exe"

• 请注意：r_binary指向的是R（用于交互式控制台），而非Rscript（用于运行整个文件）。两者的路径常常不同。
• 不要直接把which R的输出结果填进去。某些shell别名可能会产生误导。在macOS/Linux上，建议使用realpath $(which R)；在Windows PowerShell上，使用Get-Command R | Select-Object -ExpandProperty Path来获取真实路径。
• 修改后保存设置，按Ctrl+Shift+P，输入R-Box: Show R Version即可验证设置是否生效。

plot() 和中文输出为什么没反应？

Sublime Text的构建面板仅捕获标准输出（stdout），而plot()函数默认会启动一个图形设备，如X11、quartz、windows。

cat()和print()的换行行为也和终端不一致。这并非配置错误，而是机制本身的限制。

• 图形函数必须显式指定设备并保存。例如：png("plot.png"); plot(1:10); dev.off()。否则，图像不会出现在构建面板中。
• Windows平台下的中文乱码问题，通常是由于默认编码不是UTF-8造成的。你需要在.sublime-build文件中添加"encoding": "UTF-8"项，或者在R脚本首行加上# -*- coding: utf-8 -*-。
• 如果library()报错“找不到包”，大概率是工作目录设置问题（working_dir没有设为$file_path），或者R启动时没有加载用户库路径。此时，可以通过R-Box: Start R手动打开控制台，运行.libPaths()来查看实际的包路径。

问题的本质是什么

说到底，真正让人卡住的，往往不是语法或插件本身。

• Rscript的路径没写对
• 反斜杠漏了一个
• R的版本号填错了
• 误以为Sublime Text能像RStudio那样“自动理解上下文”

它不能。它只认你给的那条命令和那个路径。