断点不触发的三大原因:调试器未真正附着、source map 路径未对齐、变量作用域理解错误;需依次检查状态栏提示、launch.json 配置、sourceMap 生成与映射设置,以及 Watch/调试控制台精准查值。
断点不触发?先确认调试器是否真在跑
VS Code 里点了行号左边出现红点,但按
后程序飞快跑完、完全不停——大概率不是断点坏了,而是调试会话根本没启动成功,或者压根没连上目标进程。
检查底部状态栏:出现「调试正在运行」字样才算真正附着;没这行字,说明
配置失败或没选对配置项
Node.js 项目必须确保
是
(不是
旧写法,除非你明确用了新版 Debugger for Node.js 扩展),且
指向可直接执行的入口文件,比如
前端调试 Chrome 时,不能只配
就完事:得先装好
插件,再确保 Chrome 是用
启动的,否则 VS Code 连不上
如果用的是
模式(比如 Docker 容器里跑的 Node),要核对
和
:容器内常需设
并暴露端口,本地默认
是连不进去的
TypeScript 或 Vue 项目断点跳到 .js 文件?sourceMap 没对齐
你在
打了断点,结果调试时停在
的某一行,变量名全是
,甚至行号错位——这不是 VS Code 的锅,是 source map 路径解析失败了。
编译阶段必须生成
文件:
里要有
;Vite 用户检查
中
是否为
;Webpack 用户确认
设为
或
必须显式启用映射:
,并告诉 VS Code 去哪找编译产物:
多包项目(如
)容易漏掉路径:
这行不加,VS Code 就不知道该把
映射回哪个
目录
验证是否生效:打开「调试控制台」,搜
,看到类似
且无 404,才算真正加载成功
条件断点和日志点怎么用才不翻车
右键断点选「编辑断点」输个
很简单,但实际用起来常因作用域或副作用出问题。
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
条件表达式只能读,不能改状态:
、
、
都不准写,VS Code 不保证执行顺序,可能跳过、重复或干脆不触发
命中次数断点适合循环调试:右键 →「命中条件」→ 输入
,表示第 10 次执行到这行才中断,比手动点 9 次「继续」靠谱得多
日志点(Log Point)本质是静默
:
,输出到调试控制台,不暂停执行,适合高频位置埋点
注意语法:模板字符串用
,普通 JS 表达式直接写,比如
是合法条件,但
会报错
变量看不清?别硬点展开,用 Watch 和调试控制台精准捞数据
“变量”面板里一堆
、
、
,点开十几层还找不到想要的字段——这不是功能缺陷,是你没用对工具。
深层属性别手翻:在「监视」(Watch)面板直接输入
或
,只要当前栈帧能访问,就立刻求值显示
Promise 要等结果:暂停在 async 函数里时,在调试控制台输
,就能拿到 resolve 后的值;输
只能看到 pending 状态
DOM 元素查属性更快:悬停变量上看不到
?直接在控制台输
或
,比点小箭头省三步
大数组/对象被截断?右键变量 →「Store as global variable」生成
,再输
格式化输出
断点调试不是点一下就灵的事,它卡在三个地方:调试器有没有真正附着、source map 路径能不能精准对齐、变量到底在哪个作用域里活着。这三个环节任一断掉,红点就只是个红点。
F5launch.jsontype"node""pwa-node"program"${workspaceFolder}/index.js"launchDebugger for Chrome--remote-debugging-port=9222attachportaddress"address": "0.0.0.0""localhost"src/index.tsdist/index.js_a_b.maptsconfig.json"sourceMap": truevite.config.tsbuild.sourcemaptruedevtool'source-map''inline-source-map'launch.json"sourceMaps": true"outFiles": ["${workspaceFolder}/dist/**/*.js"]packages/foo/src"resolveSourceMapLocations": ["${workspaceFolder}/packages/**/src/**", "!**/node_modules/**"]dist/foo/index.jssrc/Loaded source map fromLoaded source map from 'file:///xxx/dist/index.js.map'i === 5i++arr.pop()console.log()10console.log当前值: ${i}, 时间戳: ${Date.now()}${}user?.token?.length > 0let x = 1ObjectPromise {} Array(1000)response.data.items[0].nameJSON.stringify(errors, null, 2)await myPromisemyPromiseinnerHTMLel.innerHTMLel.classNametemp1JSON.stringify(temp1, null, 2)