VS Code调试Karate需配置三大扩展：Cucumber(Gherkin)支持语法高亮、Debugger for Java启动JVM调试、Java Extension Pack保障Java类识别；并正确设置launch.json指向com.intuit.karate.cli.Main，确保.feature文件被Maven打包进classpath且路径大小写准确。
VS Code 安装 Karate 必备扩展
VS Code 本身不原生支持 Karate，必须靠扩展补足语法高亮、调试入口和运行能力。只装一个扩展是不够的，得配齐三个核心组件：
-
Cucumber (Gherkin) Full Support：提供.feature文件语法高亮和 Gherkin 关键字提示（Given/When/Then等） -
Debugger for Java：Karate 运行在 JVM 上，调试依赖此扩展启动 Java 进程 -
Java Extension Pack（含 Language Support for Java™）：确保.java类能被识别，尤其当你写自定义 Java 工具类或 Hook 时
注意：Karate Runner 或第三方“Karate 插件”多数已过时或不维护，官方明确推荐用上述组合。装完重启 VS Code，否则 .feature 文件可能仍显示为纯文本。
配置 launch.json 启动 Karate 测试
VS Code 的调试能力靠 .vscode/launch.json 驱动。Karate 没有独立的调试器，本质是调用 com.intuit.karate.cli.Main 主类，所以配置必须指向它：
{
"version": "0.2.0",
"configurations": [
{
"type": "java",
"name": "Debug Karate",
"request": "launch",
"mainClass": "com.intuit.karate.cli.Main",
"args": ["test", "classpath:features/api"],
"env": {
"KARATE_OPTIONS": "--tags @smoke"
}
}
]
}
关键点说明：
-
args中test是固定命令；classpath:features/api表示从 classpath 加载features/api目录下的.feature文件（路径需与你实际资源目录一致） -
KARATE_OPTIONS支持传参，比如--tags @debug只跑带@debug标签的场景，比改代码更灵活 - 不要写成
args: ["-jar", "karate.jar", ...]—— Maven 项目下 jar 不在本地，直接走 classpath 更可靠
确保 Maven 资源正确打包到 classpath
VS Code 调试时读的是编译后的 classpath，不是源码路径。如果 .feature 文件没被 Maven 复制进 target/test-classes，就会报错 Feature not found: classpath:...。
检查你的 pom.xml 是否包含以下配置：
<build>
<testResources>
<testResource>
<directory>src/test/java</directory>
<excludes>
<exclude>**/*.java</exclude>
</excludes>
</testResource>
<testResource>
<directory>src/test/resources</directory>
</testResource>
</testResources>
</build>
常见错误：
- 只把
.feature放在src/test/java下，但没配<testResource>→ 文件不会进 classpath - 路径写错，比如
args写成classpath:src/test/features→ classpath 里没有这个前缀 - 没执行过
mvn test-compile，target/test-classes是空的 → 调试前先手动运行一次测试
运行单个 .feature 文件的快捷方式
不想每次进调试界面？可以用终端快速验证：
- 打开集成终端（
Ctrl+`），确保在项目根目录 - 执行：
mvn test -Dtest=KarateTest -Dkarate.options="classpath:features/demo.feature" -
KarateTest是你写的 JUnit 启动类名（继承Karate或用@Karate.Test注解）
这个命令绕过 IDE 配置，直击 Maven 生命周期，适合排查“为什么 launch.json 不生效”。如果终端能跑通但 VS Code 调试失败，基本锁定是 launch.json 路径或 classpath 配置问题。
最易被忽略的一点：Karate 的 classpath 查找是大小写敏感的，features/api 和 Features/API 在 Windows 上可能看起来一样，但在调试时就是两个路径。
