sublime text 运行 cucumber 的核心是正确配置环境变量、构建系统和语法绑定：需确保 path 包含 ruby/cucumber 路径，macos 用 ~/.zprofile、windows 用系统级 path；构建系统中 shell_cmd 要带 -l 加载 shell 配置，file_regex 必须匹配报错格式；.feature 文件需手动绑定 gherkin 语法；避免用 build system 执行长期进程。
Sublime Text 本身不运行 Cucumber，它只负责把 cucumber 命令交给系统执行；配置失败的根源几乎全是环境变量不可见、构建系统没匹配输出格式、或 .feature 文件未绑定正确语法——不是插件装得不够多。
验证 Sublime 是否能看见你的 Ruby 和 cucumber
别猜 PATH 有没有生效，直接看它实际用的路径：
按 Ctrl+` 打开 Sublime 控制台，输入：import os; print(os.environ.get('PATH'))
检查输出里是否包含以下任一路径：
- macOS Homebrew：
/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel） - rbenv 用户：
/Users/yourname/.rbenv/shims（注意必须写绝对路径，~不解析） - Windows：
C:Ruby32-x64in（确认该目录下存在cucumber.bat或cucumber.cmd）
如果没出现，后续所有构建配置都会静默失败。macOS GUI 应用默认不读 ~/.zshrc，应改写入 ~/.zprofile；Windows 则必须把 Ruby 的 bin 目录加进「系统环境变量」PATH，而非仅用户变量。
配置 Cucumber 构建系统（关键在 shell_cmd 和 file_regex）
Sublime 默认没有 Cucumber 构建项，需手动创建 Cucumber.sublime-build（存于 Packages/User/）：
macOS/Linux（zsh 用户）：
{
"shell_cmd": "zsh -l -c 'cucumber "$file"'",
"file_regex": "^([^:]*?):([0-9]+):?([0-9]*)",
"selector": "source.feature",
"encoding": "utf-8"
}
Windows（必须硬编码路径）：
{
"cmd": ["C:\Ruby32-x64\bin\cucumber.bat", "$file"],
"file_regex": "^([^:]*?):([0-9]+):?([0-9]*)",
"selector": "source.feature",
"encoding": "utf-8"
}
注意三点：
-
shell_cmd中的-l是关键：它让 zsh 以登录态启动，自动加载~/.zshrc，从而识别 rbenv/rvm 管理的cucumber版本 -
file_regex必须匹配 Cucumber 实际报错格式，例如features/login.feature:12—— 若用错正则，双击错误行无法跳转 - 不要用
"cmd": ["cucumber", "$file"]这种裸调用，GUI 下大概率报command not found
让 .feature 文件真正被识别为 Cucumber
Sublime 不会自动把 .feature 文件当 Cucumber 处理，右下角显示 “Plain Text” 是常态，这不是插件缺失：
- 打开任意
.feature文件 → 点右下角语言名（如 Plain Text）→ 选 Ruby on Rails → Gherkin（Sublime Text 4 自带，无需额外插件） - 点击右侧出现的 Open all with current extension as…，确认绑定
.feature后缀 - 若用自定义扩展名（如
.spec.feature），需在View → Syntax → Open all with current extension as…中单独绑定
语法绑定后，才能触发 selector 匹配，构建系统才会在该文件上生效。
运行 Cucumber 测试时容易卡死？别用 Build System 启动长期进程
Build System 设计用于短命命令（如 cucumber --dry-run 或单个场景），强行运行 cucumber --watch 或后台服务会导致：
- Sublime 主进程无响应
- 进程无法终止，端口/锁文件残留
- 输出乱码或截断（因 Sublime 构建面板非完整 TTY）
正确做法：
- 日常调试用：
cucumber features/login.feature:12（指定行号）或cucumber -n "should log in"（模糊匹配） - 需要 watch 模式：终端执行
cucumber --watch，Sublime 专注编辑；或装Terminus插件，在 Sublime 内开独立终端 tab - 避免用 SublimeREPL 运行
cucumber—— 它不提供伪终端（PTY），很多 hook 和颜色输出会失效
最后提醒一句：Cucumber 的步骤定义（step_definitions）分散在项目各处，Sublime 的跳转（F12）天然不准；别指望靠构建系统解决符号索引问题，那是 RubyTest 或外部工具（如 Solargraph）的事。
