VSCode调试Cucumber断点不命中根本原因是Node.js子进程未被正确attach；需用node --inspect-brk启动并配置launch.json为attach模式，指定正确program路径、runtimeExecutable、args及sourceMap支持。
VSCode 调试 Cucumber 步骤定义时断点不命中
根本原因不是代码写错了，而是 Node.js 进程没被正确 attach——Cucumber CLI 启动的是子进程，VSCode 默认调试器只 attach 主进程。直接按 F5 跑 cucumber-js 命令，断点必然失效。
实操建议：
- 改用
node --inspect-brk ./node_modules/.bin/cucumber-js启动，加--inspect-brk强制在第一行暂停 - 在 VSCode 的
.vscode/launch.json中配置attach模式，而不是launch模式 - 确保
port与启动命令中的一致（默认 9229），且没有其他 Node 进程占着该端口 - 步骤定义文件必须是 JS/TS 源码（非编译后产物），否则断点会偏移或消失
launch.json 配置必须匹配 cucumber-js 实际执行路径
很多团队照搬网上模板，把 program 指向 node_modules/cucumber/bin/cucumber.js，但 Cucumber v7+ 已废弃该路径；v9/v10 使用 @cucumber/cucumber 包，入口是 dist/src/cli/index.js，硬写死路径会导致调试器找不到入口、无法注入调试逻辑。
推荐做法：
- 用
npm bin cucumber-js查看真实 CLI 路径（通常是./node_modules/.bin/cucumber-js） -
launch.json中program字段填绝对路径或${workspaceFolder}/node_modules/.bin/cucumber-js - 务必加上
"runtimeExecutable": "node"，否则 VSCode 会尝试直接执行 bin 文件（它是 shell 脚本） - 传参用
args数组，例如["--require", "src/steps/**/*.ts", "--format", "pretty"]，别拼成字符串
TS 步骤定义调试时源码映射（source map）失效
TypeScript 编写的步骤定义，断点打在 .ts 文件上却跳转到 .js，或者提示 “No generated code found for…”，说明 source map 没生效。这不是 VSCode 问题，是构建链路缺失。
关键检查点：
-
tsconfig.json中必须有"sourceMap": true和"outDir"（即使你用 esbuild/swc，也要确认其输出含.map文件） - Cucumber 加载的是编译后的 JS，所以
--require参数指向的必须是outDir下的 JS 文件，不是 TS 源文件 - 如果用
ts-node直接运行（如ts-node ./node_modules/.bin/cucumber-js），需额外加--project tsconfig.json，否则ts-node用默认配置，source map 可能被忽略 - VSCode 的
debug.javascript.autoAttachFilter设为时，需在启动命令加--inspect，否则自动 attach 失效
调试时看到 “Cannot find step definition” 却断点已打上
这说明 Cucumber 找到了文件、也加载了函数，但匹配不到 Gherkin 行——常见于正则表达式注册方式和实际步骤文本存在空格、标点、大小写偏差。调试器能停住，但步骤没被调用，容易误判为环境问题。
快速定位方法：
- 在步骤定义函数第一行加
debugger，再运行，看是否触发：不触发 = 匹配失败；触发 = 函数内逻辑问题 - 启用 Cucumber 日志：
--format-options '{"snippetInterface":"synchronous"}'+--dry-run，观察控制台输出的 “matched step” 是否包含你期望的函数名 - 注意中文步骤中的全角/半角空格、冒号（： vs :）、引号（“” vs ""），Gherkin 解析器对 Unicode 很敏感
- 若用
Given(/I login with (.*)/)这类正则，确保.*能覆盖实际文本，比如带换行或特殊字符时会 silently fail
调试 Cucumber 最容易被忽略的，是它本质上运行在独立 Node 子进程里，而 VSCode 调试器默认不穿透这层隔离。所有配置都得围绕“让调试器看见那个子进程”来展开，不是写对断点就行。
