Sublime Text 无法直接运行 R 代码，必须通过系统已安装的 Rscript 或 R 命令行工具调用；需确保 PATH 正确、构建系统配置准确、工作目录与编码设置合理，否则 Ctrl+B 必然失败。
Sublime Text 不能运行 R 代码——它只是编辑器，不带 R 解释器，所有“运行”动作本质都是调用你系统里已安装的 Rscript 或 R 命令行工具。没走通这一步，Ctrl+B 就必然失败，图形、包加载、相对路径读取全会卡住。
确认 Rscript 在终端能直接执行是硬前提
90% 的 Unable to find command 'Rscript' 错误，都源于 Sublime 启动时根本没加载你的 shell 环境（比如 .zshrc 或 Windows 系统 PATH）。即使你在终端敲 Rscript --version 有输出，Sublime 仍可能找不到它。
- macOS/Linux：在终端运行
which Rscript；Homebrew 安装通常返回/opt/homebrew/bin/Rscript，官网 pkg 安装可能是/usr/local/bin/Rscript - Windows：打开命令提示符，运行
where Rscript；典型路径是C:Program FilesRR-4.3.2inRscript.exe（注意版本号要替换成你实际安装的） - 别用 RStudio 自带的 R —— Sublime 不识别其私有路径，必须用独立安装的 R
- 验证方式：从终端启动 Sublime（macOS/Linux 执行
subl .；Windows 执行subl），再按 Ctrl+B 测试
手写 .sublime-build 文件比依赖插件更可靠
插件（如 R-Box）封装太多，容易掩盖路径或参数问题。直接写 JSON 构建定义，控制力最强，也最易排查。
- 菜单 → Tools → Build System → New Build System…，清空默认内容，粘贴以下配置（按系统选）
- macOS/Linux（Homebrew 安装）：
{ "cmd": ["Rscript", "--vanilla", "$file"], "selector": "source.r", "working_dir": "$file_path", "env": {"PATH": "/opt/homebrew/bin:/usr/local/bin:$PATH"} } - Windows（路径含空格，必须双反斜杠转义）：
{ "cmd": ["C:\Program Files\R\R-4.3.2\bin\Rscript.exe", "--vanilla", "$file"], "selector": "source.r", "working_dir": "$file_path" } -
--vanilla参数很重要：跳过用户.Rprofile，避免干扰和静默失败 -
"selector": "source.r"必须写，否则 Sublime 不知道该对 .R 文件启用这个构建系统 - 不要加
"shell": true—— Windows 上会导致窗口一闪而过，macOS/Linux 上可能破坏 UTF-8 编码处理
R-Box 插件的 r_binary 必须指向 R.exe，不是 Rscript.exe
R-Box 默认启动交互式 R 控制台（类似 RStudio 的 Ctrl+Enter），它需要的是 R 主程序，而不是批处理用的 Rscript。填错路径就会报 R process died 或完全没反应。
- 菜单 → Preferences → Package Settings → R-Box → Settings
- 在右侧用户设置中添加：
"r_binary": "C:\Program Files\R\R-4.3.2\bin\R.exe"
（Windows，注意双反斜杠）或"r_binary": "/usr/local/bin/R"
（macOS Homebrew） - 保存后重启 Sublime，再用
Ctrl+Shift+P → R-Box: Show R Version验证是否生效 - 别直接复制
which R输出——某些 shell 别名不可靠，建议用realpath $(which R)（macOS/Linux）或 PowerShell 中Get-Command R | Select-Object -ExpandProperty Path获取真实路径
最容易被忽略的是工作目录和编码：不设 working_dir，read.csv("data.csv") 就会报文件不存在；不设 LANG 或 env，中文路径或 CSV 读写就乱码。这些不是“高级选项”，而是让脚本能跑通的基本条件。
