Vue3源码解读-目录结构及构建版本解析


💡 [本系列Vue3源码解读文章基于3.3.4版本](https://github.com/vuejs/core/tree/v3.3.4)

1、目录结构

1.1 将源代码clone到本地:

jsx 复制代码
git clone https://github.com/vuejs/core.git

1.2 在终端执行 tree -aI ".git*|.vscode" -C -L 2 获取目录结构。

这里是命令的详细解释:

  • tree: 这是调用 tree 程序的命令,它以图形方式显示目录结构。
  • a: 显示所有文件和目录,包括以点(.)开头的隐藏文件。
  • I ".git*|.vscode": 忽略列表,不显示与提供的模式匹配的文件或目录。在这个例子中,它会忽略所有以 .git 开头的文件和目录,以及 .vscode 目录。
  • C: 在输出中启用颜色,以区分不同类型的文件。
  • L 2: 限制目录树的显示深度为 2 层。

综上所述,这个命令会以彩色输出当前目录及其子目录的结构,但只显示到第二层,并且会忽略所有以 .git 开头的文件和目录以及 .vscode 目录。

去掉部分目录后得到以下结构:

jsx 复制代码
.
├── .eslintrc.cjs              // eslint代码风格检查工具的配置文件
├── .prettierignore            // Pretttier格式化工具忽略文件的配置文件
├── .prettierrc                // Pretttier格式化工具配置文件
├── BACKERS.md                 // 支持者列表
├── CHANGELOG.md               // 代码版本变更日志
├── LICENSE                    // 软件许可证,vue3遵循The MIT License (MIT)协议
├── README.md                  // 本项目说明
├── SECURITY.md                // 安全相关信息说明
├── changelogs                 // 存放版本变更日志的文件夹
│   ├── CHANGELOG-3.0.md
│   ├── CHANGELOG-3.1.md
│   └── CHANGELOG-3.2.md
├── netlify.toml               // Netlify 部署工具的配置文件
├── package.json               // 项目依赖和脚本的配置文件
├── packages
│   ├── compiler-core          // 编译器核心,独立于平台
│   ├── compiler-dom           // 针对浏览器的 DOM 模板编译器
│   ├── compiler-sfc           // 单文件组件(.vue)编译器的实现
│   ├── compiler-ssr           // 服务端渲染编译器的实现
│   ├── dts-test               // TypeScript 类型声明测试
│   ├── global.d.ts            // 全局 TypeScript 类型声明文件
│   ├── reactivity             // 响应式系统的实现
│   ├── reactivity-transform   // 实验性代码,会在 3.4 中从 Vue 核心中删除
│   ├── runtime-core           // 运行时核心实例相关代码
│   ├── runtime-dom            // 针对浏览器的运行时实现
│   ├── runtime-test           // 运行时测试相关代码
│   ├── server-renderer        // 服务端渲染的实现
│   ├── sfc-playground         // 单文件组件在线调试器
│   ├── shared                 // package 之间共享的工具库
│   ├── template-explorer      // 模板代码在线编译器
│   ├── vue                    // vue编译后dist产物,不同场景的引入文件
│   └── vue-compat             // 兼容旧版 API 的代码
├── pnpm-lock.yaml             // pnpm 包管理器的依赖锁定文件
├── pnpm-workspace.yaml        // pnpm 包管理器的工作区配置文件
├── rollup.config.js           // Rollup 打包工具的配置文件
├── rollup.dts.config.js       // Rollup 打包工具用于生成 TypeScript 类型声明文件的配置文件
├── scripts                    // 存放脚本文件的文件夹
│   ├── aliases.js
│   ├── build.js
│   ├── const-enum.js
│   ├── dev.js
│   ├── pre-dev-sfc.js
│   ├── release.js
│   ├── setupVitest.ts
│   ├── size-report.ts
│   ├── usage-size.ts
│   ├── utils.js
│   └── verifyCommit.js
├── tsconfig.build.json         // 用于编译打包后的代码的 TypeScript 配置文件
├── tsconfig.json               // 项目 TypeScript 配置文件
├── vitest.config.ts            // Vitest 测试工具的基础配置文件
├── vitest.e2e.config.ts        // Vite 测试工具的端到端测试配置文件
└── vitest.unit.config.ts       // Vite 构建工具的单元测试配置文件

2、模块依赖关系图

Vue3源码都放在packages目录下。

jsx 复制代码
├── packages
│   ├── compiler-core          // 编译器核心,独立于平台
│   ├── compiler-dom           // 针对浏览器的 DOM 模板编译器
│   ├── compiler-sfc           // 单文件组件(.vue)编译器的实现
│   ├── compiler-ssr           // 服务端渲染编译器的实现
│   ├── dts-test               // TypeScript 类型声明测试
│   ├── global.d.ts            // 全局 TypeScript 类型声明文件
│   ├── reactivity             // 响应式系统的实现
│   ├── reactivity-transform   // 实验性代码,会在 3.4 中从 Vue 核心中删除
│   ├── runtime-core           // 运行时核心实例相关代码
│   ├── runtime-dom            // 针对浏览器的运行时实现
│   ├── runtime-test           // 运行时测试相关代码
│   ├── server-renderer        // 服务端渲染的实现
│   ├── sfc-playground         // 单文件组件在线调试器
│   ├── shared                 // package 之间共享的工具库
│   ├── template-explorer      // 模板代码在线编译器
│   ├── vue                    // vue编译后dist产物,不同场景的引入文件
│   └── vue-compat             // 兼容旧版 API 的代码

根据模块之间的调用关系,可以得出如下的模块关系图如下:

在后面的源码分析中,我们会集中分析:@vue/reactivity、@vue/runtime-core、@vue/runtime-core、@vue/compiler-core、@vue/compiler-core包。

3、构建版本

可以通过以下命令进行构建,构建出Vue3所有的版本

javascript 复制代码
npm run build

构建好的文件在目录: core\packages\vue\dist,生成的文件有:

python 复制代码
// cjs(用于服务端渲染)
vue.cjs.js
vue.cjs.prod.js(生产版,代码进行了压缩)

// global(用于浏览器<script src="" />标签导入,导入之后会增加一个全局的Vue对象)
vue.global.js
vue.global.prod.js(生产版,代码进行了压缩,包含编译器)
vue.runtime.global.js
vue.runtime.global.prod.js(生产版,代码进行了压缩)

// browser(用于支持ES 6 Modules浏览器<script type="module" src=""/>标签导入)
vue.esm-browser.js
vue.esm-browser.prod.js(生产版,代码进行了压缩,包含编译器)
vue.runtime.esm-browser.js
vue.runtime.esm-browser.prod.js(生产版,代码进行了压缩)

// bundler(这两个版本没有打包所有的代码,只会打包使用的代码,需要配合打包工具来使用,会
让Vue体积更小)
vue.esm-bundler.js
vue.runtime.esm-bundler.js

不同版本的作用和使用场景总结如下:

版本 完整版 运行时版(runtime) 使用场景
cjs .cjs.js CommonJs,有常用在nodejs服务端的一种模块导入标准,
esm-browser .esm-browser.js .runtime.esm-browser.js 用于浏览器通过原生 ES 模块导入使用 (在浏览器中通过
esm-bundler .esm-bundler.js .runtime.esm-bundler.js 用于构建工具(webpack,rollup等)使用原生 ES 模块导入
global .global.js .runtime.global.js 全局变量版本
  • 完整版:包括编译器(只集成在完整版本中,用来将模板字符串编译成渲染函数)和运行时版本
  • 运行时版:由于不包括编译器,如果导入的vue是运行时版本,则要求在构建期间就要编译好

4、总结

Vue3的源码采用pnpm实现monorepo管理的方式,这种方式可以将不同的功能模块分开管理,使得代码更加结构化和可维护。好处如下:

  1. 模块化: 代码按功能划分成不同的模块,便于管理和维护。
  2. 清晰的职责划分: 每个模块有明确的功能和职责,使得代码更加清晰和易于理解。
  3. 可维护性: 模块化的代码结构有助于定位问题和快速开发新功能。
  4. 可重用性: 独立的模块可以在不同的环境或项目中重用。
  5. 易于测试: 模块化的结构使得编写和运行单元测试更加容易。
  6. 优化打包: 通过模块化,现代打包工具可以更好地进行树摇(tree-shaking)等优化,减少最终构建的体积。
  7. TypeScript 支持: Vue 3 使用 TypeScript 编写,模块化有助于提供类型安全和更好的开发体验。

5、参考资料

[1] Vue官网

[2] Vuejs设计与实现

[3] vue3不同构建版本

欢迎关注我的公众号:前端Talkking

相关推荐
新缸中之脑9 分钟前
Llama 3.2 安卓手机安装教程
前端·人工智能·算法
hmz85612 分钟前
最新网课搜题答案查询小程序源码/题库多接口微信小程序源码+自带流量主
前端·微信小程序·小程序
看到请催我学习19 分钟前
内存缓存和硬盘缓存
开发语言·前端·javascript·vue.js·缓存·ecmascript
blaizeer1 小时前
深入理解 CSS 浮动(Float):详尽指南
前端·css
速盾cdn1 小时前
速盾:网页游戏部署高防服务器有什么优势?
服务器·前端·web安全
小白求学11 小时前
CSS浮动
前端·css·css3
什么鬼昵称1 小时前
Pikachu-csrf-CSRF(POST)
前端·csrf
XiaoYu20022 小时前
22.JS高级-ES6之Symbol类型与Set、Map数据结构
前端·javascript·代码规范
golitter.2 小时前
Vue组件库Element-ui
前端·vue.js·ui
道爷我悟了2 小时前
Vue入门-指令学习-v-on
javascript·vue.js·学习