断点必须设在可执行语句上,如赋值、函数调用、return等;空行、注释、声明行不可设断点。前端调试需确保VS Code连上真实Chrome实例,正确配置Debugger扩展、启动参数、launch.json及禁用缓存。

断点必须设在可执行语句上
空行、注释、function声明行、if或for关键字所在行本身不可中断——VS Code 会显示空心红点,悬停提示 Unbound breakpoint。真正能停住的只有表达式语句、赋值语句、函数调用、return、await、throw 等实际执行单元。
常见翻车点:
- 在
for (let i = 0; i 这一行设断点 → 不触发(只是声明) - 在
console.log(i);或const item = list[i];这一行设 → 才有效 - Vue/React 模板中写的
{{ user.name }}无法设断点,得去对应的setup()或render函数里找真实 JS 表达式位置
sourceMap 必须对齐且被加载
你在 src/App.tsx 第 42 行点了断点,结果调试时停在 dist/main.js 的第 1 行,变量名变成 _a、_b——这不是断点失效,是 sourceMap 没加载成功。
关键检查项:
-
tsconfig.json中确认"sourceMap": true - Vite 项目:检查
vite.config.ts中build.sourcemap是否为true(不是'inline'或false) -
launch.json中必须有:"sourceMaps": true和"outFiles": ["${workspaceFolder}/dist/**/*.js"] - 多包项目(如
packages/ui/src)要加:"resolveSourceMapLocations": ["${workspaceFolder}/packages/**/src/**", "!**/node_modules/**"] - 打开「调试控制台」搜
Loaded source map from,看到无 404 的路径才算真加载
条件断点别写副作用表达式
右键断点选「编辑断点」输 i === 5 很简单,但一旦加了 i++、console.log()、localStorage.getItem(),断点大概率不触发,且不报错。
合法表达式只读、无副作用:
- ✅
user?.id === 123、response.status >= 400、items.length > 0 - ❌
i = 5(赋值)、myHelper(x)(函数调用)、/error/.test(msg)(正则字面量在部分 Node 版本中解析失败) - 注意作用域:
data.code前先判空,写成data && data.code === 404更稳
前端调试必须连上真实浏览器实例
点了 F5 却没反应,或断点跳到空白行、压缩代码里——大概率 VS Code 根本没连上 Chrome。
必要条件:
- 已安装官方扩展
Debugger for Chrome(新版推荐用ms-vscode.js-debug,内置) - Chrome 必须用
--remote-debugging-port=9222启动(手动或脚本),不能直接双击图标打开 -
launch.json中"url"要和开发服务器实际地址一致(如"http://localhost:5173"),且"webRoot"指向源码根目录 - DevTools → Network → 勾选
Disable cache,否则可能加载旧的、无 map 的资源
最易忽略的一点:Vite/webpack 开发服务器启动后,再点 F5;如果服务没跑,VS Code 会静默失败,状态栏也不显示「调试正在运行」。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











