要在 vscode 中调试 vue 项目，需先安装 debugger for chrome 和 vue language features (volar) 插件；接着配置 launch.json 文件以设置调试器启动参数；然后运行项目并使用调试功能设置断点进行调试；最后确保 vue.config.js 中开启了 source map 支持。具体步骤为：1. 安装必要插件；2. 创建或修改 .vscode/launch.json 配置文件；3. 启动项目后通过 vscode 调试界面连接浏览器并设置断点；4. 检查 source map 配置以确保调试体验流畅。
调试 Vue 项目在 VSCode 中其实挺常见的，尤其是使用 Vue CLI 搭建的项目。只要你配置得当，调试起来和普通 HTML/JS 项目差不多方便，甚至更高效。
下面我分几个步骤讲清楚怎么在 VSCode 里运行并调试 Vue 项目。
安装必要的插件
VSCode 调试功能强大，但默认不支持直接调试前端代码，需要安装一些扩展来辅助。
立即学习“前端免费学习笔记（深入）”；
推荐安装以下两个插件：
- Debugger for Chrome（如果你用的是 Chrome 浏览器）
- Vue Language Features (Volar)（提升 Vue 文件的智能提示和调试体验）
如果你使用的是 Edge 或 Firefox，也可以找对应的调试插件，不过 Chrome 插件最常见也最稳定。
配置 launch.json 启动调试器
这是最关键的一步，告诉 VSCode 怎么启动调试会话。
- 在项目根目录下，找到
.vscode文件夹（如果没有就新建一个）。 - 在里面创建或修改
launch.json文件。 - 添加如下配置内容（以 Chrome 为例）：
{
"version": "0.2.0",
"configurations": [
{
"type": "pwa-chrome",
"request": "launch",
"name": "Launch Chrome against localhost",
"url": "http://localhost:8080",
"webRoot": "${workspaceFolder}/src",
"sourceMapPathOverrides": {
"webpack:///src/*": "${webRoot}/*"
}
}
]
}注意：这里的端口号
8080是 Vue CLI 默认启动的端口，如果你改了端口，请同步修改这个值。
设置断点并开始调试
当你把上面两步都做好后，就可以开始调试了。
- 先在终端运行你的 Vue 项目（通常是
npm run serve）。 - 然后点击 VSCode 左侧的“运行和调试”图标（或者快捷键 Ctrl+Shift+D）。
- 找到刚才添加的调试配置，点击“启动”按钮。
- 此时浏览器会自动打开，并连接上调试器。
- 在
.vue文件中的 JavaScript 代码部分打上断点，刷新页面就能看到效果了。
你可以做的事包括：
- 查看变量当前值
- 单步执行代码
- 查看调用栈
- 修改变量值临时测试逻辑
小技巧：调试时别忘了 source map
有时候你会发现断点打不到正确的位置，或者调试面板显示的是编译后的代码，而不是你自己写的源码。这通常是因为没有正确生成或识别 source map。
确保你在开发环境开启了 source map：
在 vue.config.js 中加上：
module.exports = {
devServer: {
// 其他配置...
},
configureWebpack: {
devtool: 'source-map'
}
}这样可以保证调试器能正确映射到你的源代码位置，不至于调试一堆匿名函数。
基本上就这些操作了。虽然看起来有点步骤，但只要配一次，之后每次调试都能一键搞定。关键是记得检查端口、路径是否匹配，还有浏览器调试插件是否安装好。
