Sublime Text中为Ruby添加-d调试参数需用"cmd"显式重定向stderr到stdout，并更新file_regex以匹配trace:前缀；直接写["ruby", "-d", "$file"]会导致跳转失效。
Sublime Text构建系统里怎么加ruby -d调试参数
想用ruby -d看变量追踪、方法调用栈，不能直接改"cmd": ["ruby", "-d", "$file"]就完事——Sublime的构建系统对-d输出格式敏感，stderr混杂、行号匹配失效是常态。核心问题是ruby -d会把调试信息和错误堆栈打在不同流里，而file_regex只捕获stdout默认行，双击跳转基本瘫痪。
实操建议：
- 先确认你的Ruby版本支持
-d且没被禁用（ruby -v输出含debug字样更稳） - macOS/Linux用户别用
shell_cmd套zsh -l -c 'ruby -d "$file"'——登录shell会把-d日志刷进stderr，Sublime默认不显示stderr，你只能看到空白输出 - Windows用户直接写
"cmd": ["C:\Ruby32-x64\bin\ruby.exe", "-d", "$file"]可行，但必须加"quiet": false字段，否则Sublime会过滤掉大量调试行 - 真正能稳定看到完整
-d输出的方式：用"cmd"而非"shell_cmd"，并显式重定向stderr到stdout："cmd": ["C:\Ruby32-x64\bin\ruby.exe", "-d", "$file", "2>&1"]（Windows）或"cmd": ["ruby", "-d", "$file", "2>&1"]（macOS/Linux，前提是PATH已通） -
file_regex得放宽：原版"^([^:]*?):([0-9]+):.*"会漏掉-d特有的trace:行，建议改成"^(?:trace: )?([^:]*?):([0-9]+):.*"
为什么ruby -w或ruby --verbose在Sublime里不生效
ruby -w警告和--verbose加载路径信息，在Sublime构建系统里常“静默消失”，不是参数错了，而是Sublime默认只展示非空stdout，且对warning类输出无高亮逻辑。它把warning:当普通文本吞掉，不触发任何UI反馈。
关键区别：
-
ruby -w的warning走stderr，但Sublime构建面板默认只捕获stdout；加"cmd": ["ruby", "-w", "$file", "2>&1"]才能看见 -
--verbose输出极多，容易触发Sublime构建面板缓冲区截断（尤其Rails项目），建议搭配head -n 50管道使用："shell_cmd": "ruby --verbose '$file' 2>&1 | head -n 50" - 若只想查require路径问题，用
ruby -e "puts $:"比--verbose更直接，可单独建一个Ruby-Paths.sublime-build快速验证 - 别依赖
path字段补加载路径——它只影响子进程环境变量，不改变Ruby自身的$:，真要调试load失败，得在代码里加p $:或puts $LOADED_FEATURES.grep(/your_gem/)
调试时怎么传命令行参数给Ruby脚本
写ruby script.rb arg1 arg2没问题，但Sublime里$file只代入文件路径，没法自动拆分后续参数。硬编码写死参数灵活性差，改个参数就得切构建系统。
推荐方案：
- 用
$file_base_name配合input字段（仅Sublime Text 4.4+支持）："cmd": ["ruby", "$file", "arg1", "arg2"]——适合固定参数场景 - 更通用的做法：把参数写进脚本同目录的
.env.rb，运行时require_relative '.env'，避免构建系统频繁改动 - 如果必须交互式输参，别在构建系统里硬搞——装
Terminus插件，按Ctrl+Shift+T开终端，直接敲ruby script.rb --help，比折腾JSON配置快得多 - 注意Windows下空格路径：若参数含空格（如
"my config.yml"），必须用双引号包裹，且cmd数组里每个参数单独一项：["ruby", "$file", ""my config.yml""]，否则解析失败
file_regex配错导致调试信息无法跳转的典型表现
你明明看到test.rb:12:in `foo': undefined method这种标准报错，但双击毫无反应——八成是file_regex没覆盖实际输出格式。Ruby调试输出比普通错误多出几类变体，原生正则很容易漏。
常见漏匹配点：
-
ruby -d会在每行前加trace:，原正则^([^:]*?):([0-9]+)会卡在trace:test.rb上，得改成^(?:trace: )?([^:]*?):([0-9]+) - Rails测试报错常带
test/controllers/posts_controller_test.rb:42:in `block in，括号和空格会让' .*吃掉行号，用^([^:]*?):([0-9]+):.*更稳 - rbenv/rvm环境下，
which ruby输出路径含~，但Sublime不展开波浪线，file_regex若写~/project/.*会完全失配，必须用绝对路径校验 - 别信网上抄来的
"file_regex": "^.*?([^\s]*?):([0-9]*?):([0-9]*?):"——Ruby错误从不带第三个数字（列号），第三组永远为空，反而拖慢匹配
最简验证法：在控制台跑ruby -e "raise 'boom'" 2>&1，复制完整输出，粘贴进regex101.com测你的file_regex是否能捕获第一组（文件名）和第二组（行号）。
