前端排查问题有个分水岭:不会用工具的人靠改代码试,改十次猜中一次;会用工具的人先看浏览器里到底发生了什么,再动手。比如「CSS 改了没生效」,可能根本不是缓存,而是另一条选择器优先级更高;「接口报 500」也不一定是后端问题,可能请求压根没发出去。

这篇按最常见的几类现场讲开发者工具怎么用:看结构和样式、看日志、打断点、看网络请求、看性能、看内存、看存储。读完你能做到:遇到问题先知道该打开哪个面板,而不是盲目刷新和改代码。工具在不同浏览器里长得不一样,下面以 Chrome 和 Edge 自带的 DevTools 为例,其他浏览器功能大同小异。

先看面板分工:

常用面板对应的问题
样式问题看 Elements
逻辑问题看 Sources
请求问题看 Network
卡顿看 Performance
内存看 Memory

Elements:样式为什么没生效

打开 Elements 面板,点左上角的检查图标再点页面元素,就能看到它的 DOM 结构和右侧的样式。判断「样式没生效」分三步:

  • 右侧 Styles 里这条规则在不在?被划掉说明被更高优先级的规则覆盖了,鼠标移上去能看到它被谁覆盖。
  • Computed 里最终算出来的值是什么?这里显示的是浏览器真正采用的值,比 Styles 里的一堆声明更可靠。
  • 页面元素的状态对不对?用 :hov 强制 :hover、:focus 这些状态,能验证是不是「只有悬停时才生效」的样式。

还有一种情况:改完 CSS 线上没变化,但本地正常。先看 Network 里这个 CSS 文件的响应头,是不是被缓存了;再看文件名有没有带版本号。这类问题在请求、缓存与跨域里讲过。

在 Elements 里改样式只能临时生效,刷新就没了。它的价值是「验证假设」:先在这里改成一个确定的值,确认是不是选择器的问题,再去改代码。别把它当成编辑器用。

Console:日志要打得有信息量

很多人只用 console.log 打印一个对象,结果看到 [object Object] 或者一串折叠的节点。几个更实用的用法:

console.table(users);              // 数组/对象打成表格,一眼看字段
console.dir(element);              // 看 DOM 对象的属性,而不是 HTML
console.time('render');            // 计时开始
renderList();
console.timeEnd('render');         // 打印耗时

console.assert(total === expected, '合计对不上', { total, expected });

排查「值什么时候被改的」时,可以在 Sources 里给变量加「日志断点」,而不是到处插 console.log,改完还得记得删。Console 里还可以直接访问最近一次打印的结果:用 $_ 引用它,省得重新选元素。

上线代码里留大量 console.log 会拖慢页面,也容易把内部数据结构暴露给用户。构建时统一移除,或者用带级别的日志函数控制输出。

Sources:断点比猜快得多

「这个变量明明赋值了,用的时候怎么是空的」这种问题,靠日志往往越查越乱。正确做法是打断点:在 Sources 里打开对应源文件,点行号加断点,复现操作,代码就会停在那一行。

停下来之后,右侧能看到当前作用域里的所有变量,鼠标悬停也能看值。几个常用操作:

  • 单步跳过(Step over):执行当前行,不进入函数内部。
  • 单步进入(Step into):进入当前行调用的函数。
  • 跳出(Step out):执行完当前函数,回到调用它的地方。
  • 条件断点:右键行号设置「只有 id === 42 时才停」,避免在循环里停几百次。
  • 调用栈(Call stack):看这个函数是被谁调用的,顺着往上找问题源头。

对异步代码,调用栈默认可能断在 await 之后,看不出最初是谁发起的。可以在设置里打开异步调用栈(Async stack traces),或者直接在发起请求的地方加断点。

Network:请求到底发生了什么

接口相关的问题,先看这里。点开一条请求,重点看四块:

区域能看到什么适合排查
Headers请求地址、方法、状态码、请求头和响应头404、跨域、缺少鉴权头
Payload请求体里实际发了什么参数漏传、字段名写错
Response服务器返回的原始内容返回结构不对、报错信息
Timing排队、连接、等待、下载各花了多久是网络慢、服务端慢还是下载慢

几个很实用的判断:

  • 列表里根本没有这条请求,说明代码没发出去,或者被前端逻辑拦住了,别去查后端。
  • 状态码是 200,但页面数据不对,看 Response 和前端解析逻辑,可能字段名对不上。
  • 状态显示 (failed) 或 CORS error,先看是不是预检失败,再按跨域那篇的顺序排查。
  • Timing 里「等待服务器响应」很长,「内容下载」很短,说明是后端处理慢,不是文件大。
  • 右键请求可以「复制为 fetch」,把现场直接贴到 Console 里重放,不用重新点页面。

调试环境差异时,记得打开网络限速(Slow 3G 之类),模拟弱网。很多「偶发白屏」「加载慢」只有限速之后才复现。

Performance:一帧的时间花在哪

页面卡的时候,Performance 面板是唯一能回答「到底慢在哪」的地方。操作流程:打开面板,点录制,操作页面复现卡顿,停止录制,然后看结果。

结果里信息很多,先看三处:

  • 顶部的帧条:有没有长条、红色三角。长条代表这一帧耗时过长,红色通常表示掉帧。
  • 主线程轨道:找最长的那一段,点开看是一大块 JS 执行、样式计算、布局还是绘制。黄色偏 JS,紫色偏样式布局,绿色偏绘制。
  • Summary 和 Bottom-up:Summary 按类别汇总时间,Bottom-up 按函数汇总,能看出是哪个函数吃掉了最多时间。

如果看到明显超过 50 毫秒的长任务,展开它,通常能定位到具体函数。这时候再决定是拆任务、加防抖,还是把计算挪进 Worker,而不是先猜。

录制本身有开销,结果会比真实情况稍慢一点。用它做相对比较没问题,别拿它当精确的线上指标。线上真实数据要靠埋点和监控收集,不是靠本地录屏。

Memory:越用越慢怎么查

怀疑内存泄漏时,用 Memory 面板拍堆快照(Heap snapshot):先拍一张,做一段操作(比如反复打开关闭弹窗、来回切换页面),再拍一张,对比两次的对象数量和大小。

看的时候重点找「你以为该被销毁、结果还在」的对象,比如某个弹窗的 DOM 节点、某个组件的实例。点开引用链(Retainers),能看到是谁把它留住了,常见的是全局缓存、没清理的定时器、没移除的事件监听器。

注意快照会暂停页面,拍的时候别期待还能正常操作。也别在开发环境里拍完就下结论,开发工具和热更新本身会持有一些对象,最好用生产构建复现。

Application:存储、缓存和 Service Worker

「登录态怎么没了」「本地数据怎么还是旧的」,去 Application 面板看:

  • Storage 区域能看到 localStorage、sessionStorage、IndexedDB、Cookie 的实际内容,可以直接删掉某一条来复现「首次访问」的状态。
  • Cache Storage 里能看到 Service Worker 缓存了哪些资源。如果你改了代码但页面一直是旧的,检查是不是 Service Worker 还在用旧缓存。
  • Clear site data 可以一键清掉当前站点的存储,适合验证「用户清了缓存之后会怎样」。

这一块和浏览器存储那篇对应。排查时不要只看代码,先看浏览器里实际存了什么。

排查方法论:工具之外的几条经验

工具会用只是第一步,真正拉开差距的是排查顺序:

  • 先稳定复现:偶发问题先找触发条件,是特定数据、特定网络、还是特定操作顺序。不能复现的问题,修了也不知道有没有修好。
  • 缩小范围:用二分法,注释掉一半逻辑、禁用一半组件,看问题还在不在。比盯着代码猜快得多。
  • 一次只改一个变量:同时改三处,问题消失了也不知道是哪处起作用,下次还会复发。
  • 别相信「我这边没问题」:对比环境差异,浏览器版本、网络、登录状态、缓存、构建模式。很多线上问题在本地开发模式下根本不会出现。
  • 用生产构建排查:开发模式的代码体积、时序、热更新都和线上不同,有些卡顿只在生产构建里出现,有些只在开发模式里出现。
  • 留下证据:把请求截图、报错堆栈、复现步骤记下来。只描述「很卡」没法推动别人一起查。

还有一个容易忽略的细节:调试工具本身会改变程序行为。比如你在 Console 里打印了一个对象,浏览器会保留它的引用,可能让本该被回收的对象一直活着。排查内存问题时,先关掉多余的日志再测。

走一遍真实排查:按钮该是蓝的,线上是灰的

产品提了一个问题:详情页的「立即购买」按钮应该是蓝色,线上截图里是灰色。设计稿、代码、线上表现三样对不上,这种问题用工具查,比在代码里翻要快得多。

第一步,先确认规则在不在。在 Elements 面板选中那个按钮,右侧 Styles 里能看到所有命中它的规则。这里有个关键读法:被划掉的声明表示被别的规则覆盖了,不是没写。看到的实际情况是蓝色规则存在,但被一条更靠后的规则划掉,最终生效的是灰色。

第二步,找是谁覆盖的。在 Styles 里点开那条生效的规则,能看到它来自哪个文件、第几行、选择器是什么。这次是一条通用的 button { background: #ccc },而蓝色规则写的是 .btn-primary。两个选择器优先级不同,通用规则里如果带了更强的限定,或者加载顺序在后,就会赢。

这里有个容易犯的错。很多人看到不生效,第一反应是「加 !important」。加上确实会变蓝,但下次别人再想改这个按钮,就得加两个 !important。正确做法是提升选择器的明确程度,或者把通用规则收窄,让优先级回到正常水平。

另一个方向的坑。如果 Styles 里根本搜不到这条规则,那就不是覆盖问题,而是选择器压根没匹配上:类名拼错(btn-primay)、构建时被裁剪、或者规则写在了没被引入的文件里。用 Ctrl+F 在 Elements 里搜类名,比肉眼找快。

改完本地好了,线上还是灰的。这时换到 Network 面板,看那个 CSS 文件的请求:文件名里的哈希变没变、内容是新的还是旧的、状态码是 200 还是 304。如果文件和本地一致,再看是不是有一层缓存或 CDN 没刷新。这一步能把「代码问题」和「发布问题」分开。

顺手查的另一件事。同一个页面上「加入购物车」点了没反应,Console 里有一条 Cannot read properties of undefined,指向一段取 data.skuId 的代码。用 Sources 在那一行下断点,重新点一次,鼠标悬停看 data 的实际值,发现接口把字段从 skuId 改成了 sku_id,前端没跟着改。这类问题看报错猜一天也猜不到,断点看一眼就清楚了。

排查顺序总结成一句:先确认「东西在不在」,再确认「在的东西对不对」,最后确认「对不对的东西是不是最新的」。样式、请求、变量都能套这三步。

现象对照:工具里看到什么,说明什么问题

你看到的现象更可能的原因第一步查什么
Styles 里规则存在,但被划掉被优先级更高或加载更晚的规则覆盖看那条生效规则来自哪个文件、选择器是什么
Styles 里完全搜不到这条规则选择器没匹配:类名拼错、文件没引入、构建时被裁掉在 Elements 里搜类名,确认它真的挂在元素上
本地改了,刷新没变化文件被缓存,或构建产物根本没包含这次修改看 Network 里文件的哈希与内容,再确认构建时间
Console 报「读取 undefined 的属性」数据结构和你以为的不一样,字段缺失或改名在 Sources 对应行下断点,悬停看实际值
请求 200,但页面没数据返回结构和解析逻辑对不上,或者外层多包了一层看 Response 原文,和代码里取的字段逐个对照
断点打了但没停下代码跑的是压缩后的另一份文件,或这个分支根本没执行看 Sources 里打开的文件是不是你写的那份,再确认条件分支

还有一类现象要单独提醒:本地一切正常,线上必现。先别改代码,先比环境——构建模式、是否压缩、是否有 Service Worker、登录态、接口域名。工具里能直接看到的部分(请求地址、响应头、存储内容)往往一眼就能暴露差异。

工具的边界和它的副作用

  • 调试会改变程序的时序。断点一停,定时器、动画、请求超时都跟真实情况不同。查「偶发」的时序问题时,断点反而会把它藏起来,这时候更适合打日志或用 Performance 录制。
  • Console 会留住对象。打印一个对象之后,浏览器为了让你展开查看,会保留它的引用。查内存泄漏时如果开着大量日志,快照里会多出一堆「本来该回收」的东西。
  • 在 Elements 里改的样式不会保存。它只是当前页面临时生效,刷新即消失。用来验证「改成这样会不会好」很快,但别忘了回到代码里改。
  • 生产环境不一定给你这些能力。线上代码通常被压缩,变量名变成短名,没有 source map 时几乎没法读;有些环境还会禁用开发者工具。这也是为什么很多问题必须在发布前用生产构建自测一遍。
  • source map 本身有代价。它能把压缩代码映射回源文件,方便排查,但也意味着源码结构对外可见,文件体积也会增加。要不要对公网开放,是需要权衡的决定,不是默认就该开。

最后一条经验:工具只能告诉你「现在发生了什么」,不能告诉你「用户那边发生了什么」。用户设备、网络、浏览器版本千差万别,线上问题最终还是要靠日志和监控去覆盖,工具负责在你手上复现并定位。

当天就能做的四件事

  1. 随便打开一个页面,在 Elements 里选中一个元素,给它加一条会被已有规则覆盖的样式,观察 Styles 里的划线与生效顺序;再提高选择器明确度,看谁赢。
  2. 写一段会报错的代码,在 Sources 里对应行下断点,刷新后单步执行,观察右侧 Scope 里变量的变化。
  3. 在 Network 里找一个接口请求,右键「复制为 fetch」,贴到 Console 里重放,改一个参数再发一次,看返回有什么不同。
  4. 打开 Performance 录三秒滚动,在结果里找出最长的一个任务,点开看它具体花在 JS、样式还是布局上。

小结与接下来读什么

把这篇压成一张对照表:结构和样式看 Elements,日志和小段验证看 Console,变量和执行流程看 Sources 断点,请求看 Network,卡顿看 Performance,内存看 Memory,存储看 Application。工具指向的是证据,先拿到证据再改代码,比反复试错省时间。

浏览器与原理这一组到这里就结束了。回头把整组串一遍:从输入网址到看见页面讲全流程,浏览器渲染管线讲画面怎么来,队列与事件循环讲代码什么时候跑,DOM 与 BOM讲怎么操作页面,后面几篇补齐请求、存储、性能和排查。

接下来可以走前端进阶篇,主题会包括框架、工程化、状态管理和更系统的性能优化;再往后是深度篇,涉及浏览器内核机制和更底层的原理。这两部分内容后续更新,暂时还没有对应文章。想先看看整体路线,可以去学习路线页面。