Sublime Text 本身不运行 RSpec，仅调用系统已安装的 rspec 命令；报“command not found”主因是 GUI 启动未加载 shell 环境变量，导致找不到 rbenv/rvm 的 shims 路径，需通过终端启动 subl、显式配置 build system 的 path 或使用 bundle exec 并设 working_dir。
Sublime Text 本身不运行 RSpec，它只负责把当前文件（比如 calculator_spec.rb）交给系统里已安装的 rspec 命令执行；配置失败的根源几乎全是环境路径没对齐——终端能跑 rspec --version，但 Sublime 启动时根本看不到你的 gem 路径或 Bundler 环境。
为什么 Ctrl+B 运行 spec 文件报 “command not found: rspec”
GUI 启动的 Sublime 不加载 shell 配置（~/.zshrc、~/.bash_profile），也就读不到 rbenv 或 rvm 注入的 PATH，更找不到你用 gem install rspec 装在 shims 目录下的 rspec 可执行文件。
- 验证方法：在 Sublime 控制台（
View → Show Console）执行import os; print(os.environ.get('PATH'))，看输出是否包含类似/Users/xxx/.rbenv/shims或/opt/homebrew/bin - macOS/Linux 用户最稳解法：别用图标启动，改用终端运行
subl .（前提是已配置subl命令），它会继承当前 shell 的全部环境 - Windows 用户请直接在构建系统中写死
rspec全路径，例如C:\Ruby32-x64\bin\rspec.bat，别依赖 PATH 查找
如何写一个能跑 RSpec 的 .sublime-build 文件
不能直接复用 Ruby 默认构建系统，因为 rspec 是独立 gem，需要显式调用，且常需配合 BUNDLE_GEMFILE 或 --require 参数支持项目级配置。
- 基础配置（适用于全局安装的 rspec）：
{ "cmd": ["rspec", "$file"], "file_regex": "^([^:]*):([0-9]+):([0-9]+): (.*)$", "selector": "source.ruby", "encoding": "utf-8", "path": "/Users/yourname/.rbenv/shims:/opt/homebrew/bin" }注意：path必须包含你的 shims 目录（rbenv）或 gem bin 路径（rvm），且不能含~，要写绝对路径 - 项目级增强（推荐）：在项目根目录建
.sublime-project，加入build_systems字段，显式指定rspec调用方式："build_systems": [ { "name": "RSpec (bundle exec)", "cmd": ["bundle", "exec", "rspec", "$file"], "file_regex": "^([^:]*):([0-9]+):([0-9]+): (.*)$", "selector": "source.ruby", "working_dir": "$project_path" } ]这样可确保使用项目Gemfile中定义的 rspec 版本，避免全局与项目版本冲突
RSpec 构建结果跳转到错误行失效怎么办
file_regex 没配对是主因。rspec 默认输出格式和 Ruby 构建系统预设的正则不兼容，尤其在启用 --format documentation 或使用 rspec_junit_formatter 时。
- 务必用
--format progress（默认）或--format d，否则file_regex匹配失败，Ctrl+Click 无法跳转 - 标准匹配正则应为：
^([^:]*):([0-9]+):([0-9]+): (.*)$，对应输出形如./spec/models/user_spec.rb:12:7: error: expected ... - 若用
bundle exec rspec且项目含.rspec，检查该文件是否加了--format或--out覆盖了默认行为 - Windows 下路径含反斜杠时，正则需改成
^([^:]*):([0-9]+):([0-9]+): (.*)$（rspec 会自动转义，无需额外处理）
真正卡住人的不是怎么写 JSON，而是 Sublime 启动那一刻它“看到”的环境和你在终端里看到的根本不是一回事；每次改完构建系统，记得关掉所有 Sublime 窗口再从终端重开，否则旧环境变量还在内存里赖着不走。
