我是怎么调试 Element UI 源码的

2022-11-11 14:47:46 浏览数 (1)

我持续组织了近一年的源码共读活动,感兴趣的可以 点此扫码加我微信 ruochuan12 参与,每周大家一起学习200行左右的源码,共同进步。同时极力推荐订阅我写的《学习源码整体架构系列》 包含20余篇源码文章。历史面试系列。另外:目前建有江西|湖南|湖北籍前端群,可加我微信进群。

简单来说就是:配置sourcemap调试源码。但挺多人可能没学 webpack 这些所以不太会。我曾经也写过类似文章。新手向:前端程序员必学基本技能——调试JS代码 推荐以下这篇文章。


上篇文章写了怎么调试 antd 的源码,反响很不错:

但很多小伙伴是写 Vue 的,可能平时用的是 Element UI 的组件库,所以这篇文章就来讲下怎么调试 Element UI 的源码。

首先,我们用 Vue CLI 创建一个 vue2 的项目:

代码语言:javascript复制
yarn global add @vue/cli

vue create element-vue-test

创建成功后,进入到项目目录

安装 element ui 的库,并在入口引入:

然后在 App.vue 里用一下 button 组件

之后 yarn run serve 把开发服务跑起来,就可以看到这样的页面:

Element UI 的组件正确的显示了。

接下来调试 button 组件的源码,那问题来了,我怎么知道在哪里打断点呢?

我们可以知道的是,这个 button 会处理点击事件,但是却不知道事件处理函数的代码在什么地方。

这种情况可以加一个事件断点:

在 sources 面板的 Event Listener Breakponts 里勾选 Mouse 的 click 事件,也就是在所有 click 事件的处理函数处断住。

然后你再点下那个按钮试试看:

你会发现它在事件处理函数处断住了。

当你知道这个组件处理了什么事件,但却不知道事件处理函数在哪的时候就可以用事件断点。

当然,这个事件处理函数并不是组件里的,因为 Vue 内部会先做一些处理,然后再交给组件处理。

所以,我们要先走到组件的事件处理函数:

单步执行、再进入函数内部,再单步执行、再进入函数内部,代码就会走到组件的事件处理函数:

methods、computed、props,这明显是源码里的了。但你再往上走两步,会发现又不是最初的源码:

template 变成了 render 函数,而且还有其他组件的代码,这明显是被编译打包之后的代码。

从文件名也可以看出来:

这是一个把所有组件代码编译后打包到一起的文件。

这样虽然也能调试,但肯定是不爽的,能不能直接调试组件最初的源码呢?就是带 template 的单文件组件那种?

是可以的,这就要用到 sourcemap 了。

sourcemap 是在编译过程中产生的:

里面记录了目标代码和源代码的映射关系,调试的时候可以通过它映射回源码:

但是你去 node_modules 下看看,会发现没有这个文件的 sourcemap:

那怎么生成它的 sourcemap 呢?

这就要从源码重新编译了。

我们从 github 把它的源码下载下来:

代码语言:javascript复制
git clone --depth=1 --single-branch git@github.com:ElemeFE/element.git

--depth=1 是只下载单个 commit,--single-branch 是下载单个 branch,这样下载速度能快几十倍,是一个加速小技巧。

进入 element 目录,安装依赖,你会遇到一个前端经常头疼的问题,node-sass 安装报错了:

这个问题的解决方案就是把 node 版本切换到 node-sass 版本对应的那个。

package.json 中可以看到 node-sass 是 4.11.0

打开 node-sass 的 github 首页:

你会看到这样一个版本对应关系表:

4.11 对应 node11,那就把 node 切换到 11 就可以了。

然后再次 yarn 安装依赖就能成功了。

之后开始编译,在 npm scripts 中可以找到 dist 命令,这就是构建源码用的:

但是我们只需要 element-ui.common.js 这个文件:

其实只需要执行其中的一部分脚本,也就是这个:

所以在项目下执行 npx webpack --config build/webpack.common.js 即可:

然后在 lib 下就可以看到构建产物:

但我们的目标是生成带有 source-map 的代码,所以要改下配置:

修改 build/webpack.common.js,配置 devtool 为 cheap-module-source-map:

source-map 是生成 sourcemap 并关联,也就是这样:

module 是把中间 loader 产生的 sourcemap 也给合并到最终的 sourcemap 里,这样才能直接映射到源码。

cheap 是加快编译速度用的,只保留行的映射信息。

改完配置后再次 yarn run dist,就可以看到带有 sourcemap 的产物了:

把这俩文件复制到测试项目的 node_modules/element-ui 下覆盖下之前的:

之后清掉 node_modules/.cache 下的缓存,重新跑 dev server:

这时会报错提示你 node 版本太低了,你需要再把 node 版本换回来:

跑起开发服务之后,再次用之前的方式调试 button 组件的源码:

你会发现现在的组件代码是带 template 语法的单文件组件的代码了!

这就是 sourcemap 的作用。

之后你会可以在这个组件里打断点然后调试。

有的同学可能会问,通过事件断点进入组件内部,这样有点麻烦,有没有更简单的方式?而且 button 组件有点击事件,但有的组件没有呀,这些组件该怎么调试呢?

确实,有了 sourcemap 之后就有更简单的调试方式了。

你可以在 sources 左边看到 ELEMENT 目录下有很多 vue 文件,这其实就是 Chrome DevTools 解析 sourcemap 之后列在这里的:

你可以直接在里面打断点调试。

比如我们加一个 tabs 组件:

把前面添加的那个事件断点去掉,在代码里手动打一个断点:

然后你就会发现,这样就可以调试 Element UI 组件源码了!

当然,有的组件找不到的时候,还是可以通过事件断点的方式来进入组件内部。

我们是通过 Chrome DevTools 调试的,其实用 VSCode Debugger 来调试它也是一样的,在 Chrome DevTools 里打的断点,在 VSCode Debugger 里同样会断住。

总结

今天我们调试了 Element UI 的源码。

定位到组件的代码,是通过事件断点的方式,因为我们知道它触发了什么事件,但却不知道事件处理函数在哪。

但是组件的代码是被编译打包过的,不是最初的源码。

为了调试最初的源码,我们下载了 Element UI 的代码,build 出了一份带有 sourcemap 的代码。

覆盖项目 node_modules 下的代码,重新跑 dev server,这时候就可以直接调试组件源码了。

有了 sourcemap 之后,Chrome DevTools 会直接把 vue 文件列在 sources 里,我们可以找到对应的 vue 文件来打断点,就不用通过事件断点来找了。

能够调试 Element UI 源码之后,想知道组件内部都有哪些逻辑的话,就可以直接在源码断点调试了,就很香。

················· 若川简介 ·················

你好,我是若川,毕业于江西高校。现在是一名前端开发“工程师”。写有《学习源码整体架构系列》20余篇,在知乎、掘金收获超百万阅读。 从2014年起,每年都会写一篇年度总结,已经坚持写了8年,点击查看年度总结。 同时,最近组织了源码共读活动,帮助4000 前端人学会看源码。公众号愿景:帮助5年内前端人走向前列。

扫码加我微信 lxchuan12、拉你进源码共读

今日话题

目前建有江西|湖南|湖北 籍 前端群,想进群的可以加我微信 lxchuan12 进群。分享、收藏、点赞、在看我的文章就是对我最大的支持~

0 人点赞