在React开发中如何快速定位组件源码_UTF_8

见贤思齐

痛点我们的主项目代码库目前已经有2800 多个组件。数千个组件构成几十个路由页面。无论是新同学或者是老同学，在定位问题或者是开发页面的时候寻找对应的源代码都相当痛苦。搜文案？搜 class？都发现有大量的重复。针对这个问题我调研了下业内相对应的解决方案。发现目前已经有一些工具或者 npm 包解决这个问题，本文就和大家分享下。解决方案方案一：chrome React Developer Tools 插件https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihiutm_source=ext_app_menu推荐指数：不快！使用方式打开 chrome devTools -> 选择 Components -> 选择 vscode 打开。可以通过自定义协议的方式打开更多编辑器选择需要打开的组件 -> 点击 open in editor（大大的箭头我找入口找了好久）。演示优点无需修改代码，安装即用；可以顺便看看组件参数；缺点操作路径复杂，需要打开控制台 - 定位组件 - 点击打开；在大型项目中经常出现加载中/加载失败/超时等问题。极度不稳定；方案二：chrome 插件推荐指数：虽然这种方式基本满足要求，但是作为提效工具要满足快准狠。相关插件：React Inspector，locatorjs(可以手动选择无法定位的层级)。使用方式安装后使用对应快捷键触发，选择需要打开的组件即可打开。演示优点无需修改代码，安装即用；操作简单；缺点依靠 react 代码生成在 fiber 节点的 _debugSource属性实现。无该属性则无法打开定位；针对一些特殊写法定位不准确，在组件内直接返回另一个组件的的编写方式下情况更明显；方案三：react-dev-inspector npm 包实现推荐指数：一次操作幸福一生！代码接入React-dev-inspector 官网有详细接入步骤。但是我在接入过程中遇到一些坑点。这里总结下我的接入方式，可以避免一些问题。安装 @react-dev-inspector/babel-plugin 和 react-dev-inspector。npmi-D@react-dev-inspector/babel-pluginreact-dev-inspector在 .babelrc 中添加 babel 插件。{"plugins":["@react-dev-inspector/babel-plugin"]}在 React-dev-inspector 中有两种调起编辑器的方式。一种是浏览器 schema 直接调起，另外一种是 node 服务调起。下面我们先看 schema 调起：schema 调起比较简单；node 中间件服务调起基于 react-dev-utils 提供的调起方法，能调起更多种类的编辑器。react-dev-utils 调起代码：https://github.com/facebook/create-react-app/blob/main/packages/react-dev-utils/launchEditor.js#L29服务中间件调起（React-dev-inspector 包默认调起方式）不推荐！在业务根组件代码中引入调起组件。import{Inspector}from'react-dev-inspector';//调起组件安装中间件服务。npmi-D@react-dev-inspector/middlewaredevServer 加入中间件。const{launchEditorMiddleware}=require('@react-dev-inspector/middleware')//webpack5module.exports={...devServer:{setupMiddlewares(middlewares){middlewares.unshift(launchEditorMiddleware)returnmiddlewares},},}//webpack4module.exports={...devServer:{beforeapp,server,compiler)=>{app.use(launchEditorMiddleware)},},}react-dev-inspector 默认打包注入的路径是相对路径。再通过 node 中间件服务调起拼接路径。当代码路径和 devServer 不在同一个目录下（在微前端项目中存在子应用在不同的代码库），这种方式会出现调起失败。因为拼接的路径是接收请求处理的 node 服务的工作目录。如果子应用不在这个路径下，则会失败。针对这种场景可以采用 schema 调起解决。schema 调起将当前应用目录添加到全局变量//webpack.config.jsvarwebpack=require('webpack');module.exports={...plugins:[newwebpack.DefinePlugin({'process.env.CWD':JSON.stringify(process.cwd()),})]};自定义调起组件逻辑。importReactfrom'react';import{Inspector}from'react-dev-inspector';import{gotoVSCode,gotoWebStorm}from'react-dev-inspector/lib/Inspector/utils/editor';constInspectorPlugin=()=>{if(process.env.NODE_ENV==='development'){return({//拼接工作目录if(codeInfo.absolutePath===undefined){codeInfo.absolutePath=`${process.env.CWD}/${codeInfo.relativePath}`;deletecodeInfo.relativePath;}//调起vscodegotoVSCode(codeInfo);//调起WebStorm//gotoWebStorm(codeInfo);}}/>);}returnnull;};exportdefaultInspectorPlugin;在业务根组件代码中引入调起组件。importInspectorWrapperfrom'...';使用快捷键选择组件打开编辑器。演示优点解决了上述两种方案的缺点。调起速度快，任何节点都可以调起；缺点需要代码接入；打包时长较长(待解决)（电脑性能较差可以选择第二个方案的 locatorjs 插件）；插件下载地址locatorjs：https://chrome.google.com/webstore/detail/locatorjs/npbfdllefekhdplbkdigpncggmojpefiReact Inspector：https://chrome.google.com/webstore/detail/react-inspector/gkkcgbepkkhfnnjolcaggogkjodmlpkh参考文档react-dev-inspector 官网：https://github.com/zthxxx/react-dev-inspector加入我们「营销科学」致力于帮助品牌生意长期科学增长，通过科学的诊断、洞察、优化和度量，将品牌的人群、内容、触点和商品变得可量化、可沉淀、可优化，通过分所各类资产的变化和流转，帮助品牌做营销决策，实现在充满不确定性的大环境下，提升营销效率和和增长确定性。营销科学前端团队负责字节跳动旗下的数字化商业增长引擎「巨量云图」&「巨量算数」平台功能开发、易用性改进、数据可视化和前端工程优化，为用户提供更好的产品体验。我们的主要技术栈有 React、TypeScript、NodeJS、Taro等。点击左下角"阅读读原文"或扫描下方二维码，我们期待你的加入!团队base 北京广告前端研发工程师 - 云图：https://job.toutiao.com/s/iR59cmc9点击上方关注我们下期再见