如何在Visual Studio Code中调试k6脚本 解决Cannot find module 'k6'报错
核心问题根因
现有配置完全错用了Node调试流程来跑k6脚本。k6本身是独立的负载测试运行时,所有k6、k6/options这类模块都是k6运行时内置实现的,根本不在Node的模块搜索路径里。你用type: node的配置唤起Node进程加载打包后的JS,自然会报Cannot find module 'k6'的错。
可直接落地的配置调整步骤
- 先装必备的VS Code扩展
在VS Code扩展市场搜索安装k6官方扩展,这个扩展会提供专门的k6类型调试适配器,替代原来的Node调试逻辑,直接对接k6原生运行时。 - 彻底替换原有错误的launch.json配置
原来基于Node的调试配置根本不适用,换成下面的配置,保留你现有的Webpack前置构建任务、sourceMap逻辑就行:
关键调整说明:{ "version": "0.2.0", "configurations": [ { "name": "Debug k6 Load Test", "type": "k6", "request": "launch", "cwd": "${workspaceFolder}", "preLaunchTask": "npm: build", "program": "${workspaceFolder}/dist/Main.js", "sourceMaps": true, "outFiles": ["${workspaceFolder}/dist/**/*.js"] } ] }- 把调试类型从
node改成k6,这一步是解决模块找不到问题的核心——调试器唤起的是k6原生运行时,内置的所有k6/*模块可以被正常解析,不会再有模块缺失的报错 - 删掉原来的
protocol: inspector配置,这是Node调试的专属参数,对k6调试完全无效 - 保留原有
preLaunchTask: npm: build逻辑,确保每次启动调试前自动跑完Webpack + Babel的TS打包流程 - 保留sourceMap相关配置,支持直接在src目录下的TS源码上打断点,自动映射到dist目录下的打包后JS代码
- 把调试类型从
- 补全TS编译的类型支撑
千万别为了消类型报错去npm装k6包当依赖。只要把k6官方的TS类型声明文件放到项目的类型目录下,在你现有已经开启sourceMap: true的tsconfig.json里把类型目录加进去,让TS能识别import { Options } from 'k6/options'的类型定义就行。 - 修正Webpack的打包规则
在Webpack配置里把所有以k6开头的导入标记为外部依赖,别让Webpack傻乎乎去node_modules里找根本不存在的k6模块打进去,参考配置:
配置生效后,打包时遇到externals: [ /^k6(\/.*)?$/ ]k6/xxx的导入会直接保留原语句,不会强行把k6相关逻辑塞到dist产物里,完全匹配k6运行时的模块加载规则。
一定要避开的坑
- 别用
npm install k6来修这个报错:npm上的k6包只是帮你装k6二进制的安装器,根本不提供运行时模块,装了也解决不了Node环境下的模块找不到问题,反而容易搞乱Webpack的打包路径 - 别想着搭个Node调试框架,写几个本地文件桩模拟k6模块:这种方式下整个调试流程都跑在Node环境里,和k6原生的虚拟用户调度、指标采集、负载计算逻辑完全不搭,调试出来的结果根本不准
- 如果遇到断点失效,检查下sourceMap的相对路径配置,别把本地电脑的绝对路径写死在map文件里,确保VS Code能把dist的打包代码正确映射回src下的TS源码就行。
内容的提问来源于stack exchange,提问作者Felipe Calderano
相关产品推荐
相关产品推荐

