① 开篇
站上巨人的肩膀,看得更远
从事了多年的前端开发,打算从源码分析开始着手,慢慢分享一些心得和思路,希望自己能继续成长之余,也能找到志同道合之人。而未来,希望能为开源社区的进步作出贡献,至于当下,努力去站上巨人的肩膀,看得更远。
② 为什么要读源码
语言只是一个工具,关键还是需要我们去传达思想,解决问题
相对于被称为前端开发,我更愿意称为js开发者,因为只要是跟js沾边的东西,都要去弄懂,哪怕已经远超前端的范畴,更何况已经卷得不行的今天。
不过相对于背那些八股文,我感觉通读这个领域的源码,了解各种优秀的思想,才能真正带来技术上的进步,这也是进阶必不可少的一步。
不过建议不要为了面试需要读而读,不然适得其反,枯燥无味,浪费时间,不知所言,还不如多看别人源码分析文章来得快。
在我们未有足够经验的时候,去了解一个未知的框架,都感觉是庞然大物,不可触及。但其实遵循一定的方法,层层抽丝剥茧,就可以慢慢发现作者很多精妙的想法,甚至彩蛋,这也是读别人源码能带来的乐趣。
③ 怎样去读源码
由外到内,由浅入深
1. 应用文档
首先,不要着急直接去拉仓库代码来看,如果这个框架有相关应用文档的,先耐心看完整个应用文档,而且要看原版,如果是英语的,尽量不要找翻译的版本,因为时效性和准确性问题,可能会让你走了弯路。
部分开发者连框架很多文档提供的用法都不知道(虽然掌握的已能应付开发),就想着去看源码了,肯定是三分钟热度的。
而当看完应用文档,可以反过来想一下,如果需要实现文档的这些功能,你可以怎样做,多思考一下,或者动手写代码尝试去实现,再带着问题去拉代码,拉最新版本的代码。
2. 文件结构
第一次拉代码下来,会看到根目录很多配置文件和文档,配置那些都不是首要的,而文档类的,需要挑重点来看,但是作者一般不会写怎样开发这个项目的流程,所以也不会太重要,不过为了通读,下面会列一下较为普遍的一些配置和文档的基础用途,后续有需要再单独文章展开。
然后,关注一下源码主要文件结构,大致从文件夹命名上可以看出,一些模块或功能的划分是怎样的,形成一个大概依赖关系图。
3. package.json中的依赖
再者,我们可以看到所有的仓库源码,根目录都带有package.json,因为基本都要发到npm公共仓库来开源引用,所以这个配置很关键,下面也会展开一下常用配置项的用途。
基于这个package.json,先重点看一下“dependencies”和“devDependencies”的各项依赖,先去了解一下所有这些依赖是干什么的,看对应的文档为主,不必完整看,基本了解到每个依赖的具体用途就行。
不然你会发觉看源码里很多地方引用了很多的库,你都不知道是干什么的,就不断阻塞读源码的思路了,所以这是提前了解框架应用底座的关键,当然也可以将各项依赖列入自己的源码阅读清单后续安排阅读。
4. package.json中的脚本
了解清楚依赖的用途之后,再看一下“scripts”的各项脚本,可以发现,脚本一般分为几类:
(1)工程构建类(常用命令:dev、build等)
(2)规范校验类(常用命令:lint)
(3)单元测试类(常用命令:test)
(4)项目发布类(常用命令:release、publish等)
(5)其他脚本类
这里重点关注工程构建类,无论哪个命令,基本都是围绕工程构建框架(rollup、webpack等)的各配置项来启动的,所以这里很容易找到关键配置文件,然后顺藤摸瓜找到源码的入口文件。
5. 逻辑结构和注释
从源码入口文件开始,逐步去debug整个源码逻辑结构,可以先看函数定义和引用,再附加过程中的各项注释,形成自己的笔记文档。
后面文章关于各项源码阅读的分析,都会遵循上述的流程,去分享阅读的源码。
④ 部分配置和文档说明
README.md
项目根首要说明文档,主要说明这个项目是干什么的
CHANGELOG.md
项目更新说明文档,记录不同版本更新了什么内容
CONTRIBUTING.md
贡献代码指南,如果你想贡献源码,可以看这个指引
CODE_OF_CONDUCT.md
代码贡献契约,有不同版本的标准,主要约定贡献者的责任义务之类的内容
BACKERS.md
赞助商或支持者清单,不少开源项目就是靠这个钱来支撑开发的
SECURITY.md
安全漏洞报告指引
AUTHORS
代码作者清单
LICENSE
许可证书,一般是MIT,不同类型证书会有不同的限制
.babelrc.js
babel插件的配置文件,也可以是babel.config.js
.editorconfig
编辑器配置,例如代码缩进的方式
.eslintignore
忽略eslint校验的文件清单
.eslintrc.js
eslint的主要配置
.flowconfig
flow配置,用到flow校验数据类型项目的才有
.gitattributes
路径属性定义列表,不同配置项配置不同内容,例如配置行末字符为LF
.gitignore
git提交忽略清单,只存在本地,不会提交上去
.mailmap
映射清单,将个人的多个账号映射为1个,避免git记录不唯一
.npmignore
npm包忽略清单,只存在本地,不会发布到npm
.nvmrc
指定node版本
.prettierignore
不使用prettier格式美化的文件清单
.prettierrc.js
格式美化配置
.watchmanconfig
文件检测器watchman配置文档
.circleci文件夹
持续集成/持续部署(CI/CD)脚本
.codesandbox文件夹
codesandbox相关配置
.github文件夹
github相关脚本配置
⑤ 部分package.json配置字段
name
项目名称
version
版本号,注意三个位置的的数字意义,和前置符^和~等的适配版本范围
description
项目描述
keywords
关键词,用于npm包搜索的
private
设置true为私有,则不会被发布出去
repository
项目仓库地址
author
项目作者,只有一个
bugs
提交bug的地址
contributors
项目贡献者,可以多个
license
许可证书
engines
配置node,npm版本号等
os
设置适用系统,例如linux才能运行此模块
cpu
设置适用cpu架构,例如x64才能运行此模块
browserslist
浏览器兼容类型支持列表
scripts
脚本命令
dependencies
项目生产依赖,代表项目被应用时候,必须依赖的其他包
devDependencies
项目开发依赖,代表项目在开发时候,必须依赖的其他包
peerDependencies
项目对等依赖,代表项目在运行时候,必须依赖外部项目本身安装的依赖,而不是自身内部的依赖
main
commonJS规范下(使用require引用)指定入口,如果不指定,会默认引用根目录下index.js
module
ESM规范下(使用import引用)指定入口
browser
浏览器运行环境的模块引用入口,main和module不区分运行环境
files
指定npm包发布的文件列表,例如指定构建后的文件列表,源码不发布
workspaces
配置工作区,例如你开发的是一个大框架,包含很多子package,则将子package路径配置到工作区里,而将这个大框架的private设置为true,因为这个大框架不是你要发布的包
bin
配置自定义命令,键值将被注册为快捷脚本,对应文件入口为命令执行文件,基本脚手架都会用到这个