使用比console.log更优质的前端调试方案

news2025/1/15 23:09:32

程序调试是程序开发必不可少的一环，刚开始接触前端调试时，最常用的就是 console.log 打印变量进行调试，本文会分享一些笔者学习到的前端调试方法，减少对 console.log 调试方式的依赖，选择更优质的前端调试方案。

本文中提到的 command 键，在 Windows 系统中用 control 键替代即可

1. 为什么不用 console.log 一把梭

我们看一下使用 console.log 的步骤：

找到需要调试代码的具体位置
写上一行 console.log() 代码，传入需要打印的变量
保存，等待项目热更新完成
打开控制台，查看打印的变量值
调试结束，删掉打印的那一行代码

平时使用中你可能没发现，原来限定条件这么多，调试变量需要这五个步骤一个都不能省。
遇到复杂的函数执行逻辑时，甚至要在每个函数中打印来确定函数的执行，这种情况下实在是不怎么方便。

简单的调试还是可取的，看个人调试习惯，较为复杂的调试就不推荐使用 console.log 了

2. 使用浏览器调试

在本地代码端，可以通过添加一行 debugger; 命令，当代码执行到这一行，会自动进入调试模式
从浏览器端进行浏览器调试需要以下几个步骤：

打开浏览器开发者工具的 Sources 源代码面板
找到需要调试的文件
打断点
进入 Debugger 模式，开始调试

2.1 找到需要调试的文件

在浏览器当中直接找调试文件有两种方式：搜索文件调试和通过文件目录查找调试文件

2.1.1 搜索文件调试

如果没有打开的调试页，空页面中会当前浏览器查找文件的快捷键提示
以谷歌浏览器为例，可以通过 command + P 查找文件的方式打开需要调试的文件
在这里插入图片描述

按下 command + p 快捷键后，搜索你要调试的文件，例如 Component/index.tsx , 即可打开对应的调试文件，接下来，就可以开始打断点了。在这一步下，最便捷的打断点方式就是点击需要调试代码的行号，当代码指定到这行时，会自动进入浏览器的断点调试模式

2.1.2 通过文件目录查找调试文件

点击左上角的展开图标, 推荐勾选上这三个筛选分类选项，在左侧 “网页” Tab 下，会实时展示加载模块的文件，找到需要调试的文件，接下来就可以开始调试了
在这里插入图片描述

2.2 打 JavaScript 断点

找到文件之后就可以开始打断点了，在浏览器中最便捷也是最常用的就是直接点击行号打断点，例如这里在点击事件这一行打了断点，当触发这个点击事件时，这个断点就会被触发了。
在这里插入图片描述

此外，右键行号也可以进行添加断点，它提供了更多的选项，例如：

条件断点，指定条件为 true 时才触发断点
日志点，记录消息
其他执行操作，执行到此处、不在此处暂停等

2.3 Debugger 调试

进入 Debugger 调试模式之后，源代码面板右侧的调试控制台上方有七个按钮，分别表示

0.执行/暂停
1.跨步执行（运行下一行代码)
2.JS执行下一步(忽略异步行为)
3.JS执行上一步(忽略异步行为)
4.执行到函数末尾
5.禁用所有断点
6.启动/关闭错误时暂停执行

在这里插入图片描述

在Debugger 模式下可以查看 JavaScript 完整的执行过程，将鼠标移到执行过的变量上可以直接看到变量的值
在调试控制台下方的信息区域，可以查看断点的集合、当前函数的变量、全局变量、闭包和调用堆栈等信息

2.4 打 DOM 断点

给 DOM 元素添加断点，当DOM 元素发生变化时，会进入 debugger 模式，具体方法如下：
在控制台的元素标签页选中 DOM 节点，右键选择发生中断的条件可设置为属性修改，元素属性变化的时候，就会进入断点模式

3. 使用 VsCode 调试

谷歌浏览器的 debugger 插件已经内置了，这里以火狐浏览器举例，步骤如下：

1.安装 Debugger for Firefox

2.左侧图标点击 ”调试” ，若无配置可添加配置，按照默认的添加 lauch 方式即可，或者直接在根目录下创建一个 .vscode 目录，里面新建一个 launch.json 文件，添加上配置, 官网调试文档有必要一读, 以火

{
  // 使用 IntelliSense 了解相关属性。 
  // 悬停以查看现有属性的描述。
  // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "firefox", // 浏览器类型
      "request": "launch", // 调试连接方式，launch 为新打开一个浏览器实例调试， attach 为附加到已打开的浏览器上
      "name": "firefox", // 调试配置的名称
      "url": "http://localhost:3009/", // 调试项目的主页地址
      "webRoot": "${workspaceFolder}/src", // 文件执行路径
      "pathMappings": [{ "url": "webpack:///src/", "path": "${webRoot}/" }],
      "profile": "default-release" // 可选配置， 火狐浏览器用户档案
    }
  ]
}

profile 配置是可选的配置项，表示打开浏览器实例之后使用的用户档案，正常打开实例之后，会打开一个类似于进入了无痕窗口模式的浏览器，如果想正常进入浏览器，查看书签使用浏览器扩展，就需要这个配置项了
在火狐的地址栏中输入about:profiles 可以看到所有的档案方案，这里我直接使用了默认的档案方案

配置完成后，打上断点，然后启动项目，点击调试按钮即可启动 VsCode 调试，执行到断点的地方会自动进入 VsCode 的调试模式，和浏览器中调试方式差不多
在这里插入图片描述

4. 一些小技巧

console 打印

打印对象数组集合使用 console.table 可以更图表化的查看数据
打印 DOM 对象使用 console.dir 可以打印出 DOM 节点的具体属性

快捷键
command + option + i 快速打开开发者工具源代码面板
command + shift + c，打开开发者工具 Element 面板，并启用元素审查
查看 hover 状态下的元素
打开控制台的 source （中文源代码) 面板，按下command + 会进入 debugger 模式
选中元素，在 Element 面板右键选择强制执行状态 :hover