优雅的 React 源码调试方式

 

什么?调试 React 源码还有优雅和不优雅之分?

别着急,我们先来听个故事:

东东是一名前端工程师,主要用 React 技术栈,用了多年之后想深入一下,所以最近开始看 React 源码。

他把 react 和 react-dom 包下载了下来,在项目里引入,开发服务跑起来后,打开 Chrome Devtools 打断点调试。

优雅的 React 源码调试方式插图亿华云

这样调试了一段时间之后,他有了一些困惑:

这样调试是可以的,但是总感觉和源码有段距离,因为调试的是 react-dom.development.js

优雅的 React 源码调试方式插图1亿华云

而源码里这些逻辑是分散在不同的包里的,所以就算搞懂了逻辑,也不知道这些逻辑在哪些包里,只能靠搜索来定位。

优雅的 React 源码调试方式插图2亿华云

所以他就在想,是不是有更好的调试方式,能够调试 React 最初的源码呢?

于是,他跑来问我:光哥,你调试 React 源码会有这些问题么?你是怎么调试的呀?

我说,确实,我最开始也是调试的 react-dom.development.js,但是现在已经能直接调试 React 最初的源码了,而且是在 VSCode 里调试的,点击调用栈能直接打开对应的 React 源码文件并定位到对应行列号:

优雅的 React 源码调试方式插图3亿华云

优雅的 React 源码调试方式插图4亿华云

哇哦,这就是我想要的调试效果,这是怎么做到的呀。

想实现这样的调试效果确实还有点复杂,我们一点点来看:

首先,我们要做到在 VSCode 里调试 React 项目,而不是在 Chrome Devtools 里,这样才能做到直接打开对应的文件:

用 VSCode 调试 React 项目

我们用 create-react-app 创建一个 react 项目,然后 npm run start 跑起来。

这时候浏览器访问就可以用 Chrome Devtools 调试了:

优雅的 React 源码调试方式插图5亿华云

但我们的目标是在 VSCode 里调试,所以要添加一个 VSCode 的 debugger 配置:

优雅的 React 源码调试方式插图6亿华云

在根目录下建一个 .vscode/launch.json 的文件,添加一个 chrome 类型的调试配置,输入调试的 url。

然后点击 debug 启动:

优雅的 React 源码调试方式插图7亿华云

这时候就可以在 VSCode 里直接打断点调试了:

优雅的 React 源码调试方式插图8亿华云

用 VSCode 调试肯定会比 Chrome Devtools 方便一些。但这不是我们最主要的目的,现在调试的依然是 react-dom.development.js:

优雅的 React 源码调试方式插图9亿华云

那怎么调试 react 最初的源码呢?

这就涉及到 sourcemap 的作用了:

sourcemap

JS 代码经过编译,会产生目标代码,但同时也会产生 sourcemap。sourcemap 的作用就是映射目标代码中的位置和源码中的位置。

优雅的 React 源码调试方式插图10亿华云

比如源码中的第 3 行第 5 列的代码对应着编译后的第 1 行第 10 列的代码。

类似这样的映射有很多,经过编码以后是这样的:

优雅的 React 源码调试方式插图11亿华云

在 js 文件最后一行,加上这样一行注释就可以关联 sourcemap:

//# sourceMappingURL=http://example.com/path/to/your/sourcemap.map

调试工具支持解析 sourcemap 来映射调试的代码位置到源代码中的位置。

比如 chrome devtools 的 Sources 面板就会提示从哪个文件 source mapping 过来的,点击链接还可以跳到映射之前的文件:

优雅的 React 源码调试方式插图12亿华云

同样,VSCode Debugger 也支持 sourcemap,有个 sourceMaps 的调试配置选项来开启和关闭 sourcemap 功能,默认开启。

优雅的 React 源码调试方式插图13亿华云

那这么说我们只要让 react-dom.development.js 关联上 sourcemap,就能调试最初的 React 源码了?

理论上是这样的,但是现在下载的 react、react-dom 包里都不带 sourcemap,我们得把 React 源码下载下来自己 build:

build 出带有 sourcemap 的 react 包

用 npm 下载的 react 包是这样的:

优雅的 React 源码调试方式插图14亿华云

而我们需要的是带有 sourcemap 的代码,也就是这样的:

优雅的 React 源码调试方式插图15亿华云

这就要下载 react 源码自己 build 了:

git clone https://github.com/facebook/react

下载下来的代码执行 npm run build 就能看到 build 的产物:

优雅的 React 源码调试方式插图16亿华云

这里的 build/node_modules 下的 react 和 react-dom 包就是我们需要的。

但是现在 build 出的代码并没有带 sourcemap,需要改造下 build 流程。

优雅的 React 源码调试方式插图17亿华云

build 命令执行的是 ./scripts/rollup/build.js,打开这个文件做一些修改。

找到 rollup 的配置,添加一行 sourcemap: true,这个很容易理解,就是让 rollup 在构建时产生 sourcemap:

优雅的 React 源码调试方式插图18亿华云

再跑 npm run build,会报这样的错误:

优雅的 React 源码调试方式插图19亿华云

某个转换的插件没有生成 sourcemap。

这个是因为构建的过程中会进行多次转换,会生成多次 sourcemap,然后把 sourcemap 串联起来就是最终的 sourcemap。如果中间有一步转换没有生成 sourcemap,那就断掉了,也就没法把 sourcemap 串联起来了。

这个问题的解决只要找出没有生成 sourcemap 的那几个插件注释掉就可以了:

在 getPlugins 方法里,把这样 4 个插件给注释掉:

优雅的 React 源码调试方式插图20亿华云

这个是删除 use strict 用的,可以去掉。

优雅的 React 源码调试方式插图21亿华云

这个是生产环境压缩代码的,也可以去掉。

优雅的 React 源码调试方式插图22亿华云

这个是用 prettier 格式化代码的,也可以去掉。

优雅的 React 源码调试方式插图23亿华云

这个是添加一些头部的代码的,比如 Lisence 等,也没啥用,可以去掉。

去掉这四个插件之后,再运行 npm run build,这时候就能正常进行构建了,然后产生的代码就是带有 sourcemap 的:

优雅的 React 源码调试方式插图24亿华云

优雅的 React 源码调试方式插图25亿华云

这样我们就成功的 build 出了带有 sourcemap 的 react 包!

接下来只剩最后一步,用上 sourcemap,实现直接调试 React 最初的源码,

应用 sourcemap,调试 React 最初的源码

我们已经 build 除了带有 sourcemap 的 react 和 react-dom 包,那把这俩包复制到测试项目的 node_modules 下,就可以直接调试最初的源码了么?

还是不行。

为什么呢?

看下面这张图:

优雅的 React 源码调试方式插图26亿华云

我们改造了 build 流程,对 react 源码进行了 build,产生了带有 sourcemap 的 react、react-dom 包,这些包最终导出的是 react-xx.development.js。

之后在项目里引入,经过 webpack 打包,产生了 bundle.js 和 sourcemap。

之后调试工具运行代码的时候,会解析 sourcemap,完成从 bundle.js 到 react-xxx.development.js 的映射:

优雅的 React 源码调试方式插图27亿华云

但是并不会再次做 react-xx.development.js 到 react 最初源码的映射呀。

也就是调试工具只会解析一次 sourcemap。

那怎么办呢?

不打包 react 和 react-dom 这俩包不就行了。不经过 webpack 打包,那就没有 webpack 产生的 sourcemap,不就一次就映射到 React 最初的源码了么。

那怎么不打包这俩模块呢?

webpack 支持 externals 来配置一些模块使用全局变量而不进行打包,这样我们就可以单独加载 react、react-dom,然后把他们导出的全局变量配置到 externals 就行了。

要改动 webpack 配置的话,在 create-react-app 下要执行 npm run eject。

然后项目下会多出 config 目录和 public 目录,这俩分别放着 webpack 配置和一些公共文件。

修改 webpack 配置,在 externals 下添加 react 和 react-dom 包对应的全局变量:

优雅的 React 源码调试方式插图28亿华云

然后把 react.development.js 和 react-dom.development.js

THE END
Copyright © 2024 亿华云