如何在WebStorm中调试Vue3项目的源代码？

如何在WebStorm中调试Vue3项目的源代码？

Vue3项目必须启用 sourceMap 才能调试源码

调试Vue3源码有个硬性前提：必须生成sourceMap。否则，WebStorm根本无法将浏览器里运行的那堆压缩、编译后的代码，精准映射回你src/目录下那些熟悉的.vue或.ts文件。结果就是，你精心设置的断点要么完全失效，要么直接跳转到风马牛不相及的位置。

怎么判断sourceMap是否生效？方法很简单。打开Chrome开发者工具，切换到Sources面板，展开左侧的文件树。如果能看到webpack://或vite://这样的协议下，清晰地展示着你项目的完整目录结构（比如src/App.vue），那就恭喜你，映射成功了。反之，如果眼前只有一堆令人困惑的chunk-xxx.js文件，那基本可以断定，sourceMap没配对。

具体配置，得分情况看：

• Vite项目：首先确认vite.config.ts里没有禁用server.sourcemap（开发环境默认是开启的）。如果需要在生产环境调试，可以显式加上build: { sourcemap: true }。
• Vue CLI项目：在vue.config.js中，通过configureWebpack: { devtool: 'source-map' }进行设置。
• TypeScript项目：别忘了检查tsconfig.json，确保compilerOptions中的"sourceMap": true已经启用。

WebStorm 调试配置必须指向真实启动命令

很多开发者踩的第一个坑，就是直接使用WebStorm内置的“Ja vaScript Debug”配置。这么做基本是徒劳的——它只会加载一个静态HTML页面，然后就在空闲状态停滞不前，根本不会触发Vue应用的初始化逻辑。

正确的思路是什么？是复现你在终端里实际敲下的那条启动命令，让WebStorm以Node.js进程的方式去接管整个服务。

立即学习“前端免费学习笔记（深入）”；

• 针对Vite项目：新建一个Node.js运行配置。Ja vaScript file一栏填入node_modules/vite/bin/vite.js，Application parameters则填上dev。
• 针对Vue CLI项目：Ja vaScript file填node_modules/@vue/cli-service/bin/vue-cli-service.js，参数对应填serve。
• 这里有个关键细节：务必勾选Node parameters中的--inspect-brk选项。否则，调试器可能连接得太晚，完美错过Vue应用初始化的关键阶段。
• 另外，Working directory必须设置为项目根目录，否则路径解析会失败。

断点打在 setup() 或组合式 API 函数里才有效

断点位置的选择，直接决定了调试的成败。在