Vite 源码系列(1):Vite 启动时的命令行处理

前言

上一节中我们找到了 Vite 启动的入口文件 bin/vite.js,其内容如下。

文件的最后调用了 start方法,start 方法的作用是 import ../dist/node/cli.js 这个文件,被 import 的文件接着将会执行。 这里的 ../dist/node/cli.js 路径我们需要换成 ../src/node/cli.ts,因为我们看的是未打包 src目录下的源码。

命令行参数

在启动 Node.js 程序时可以在命令行的后面追加你需要的参数。比如 node example.js argument1 argument2,这里的argument1和argument2就是命令行参数。

在 Node.js 中有一个全局的环境变量 process,该变量上有一个 argv 属性。argv属性的值是一个数组。数组的第一位是 node 程序可执行文件的绝对路径,数组的第二位是被执行的 js 文件的绝对路径,剩下的元素是命令行中追加的参数。

我们用下面这段 js 来试一下

js 复制代码
import { argv } from 'node:process';

// 打印 argv 对象
console.log(argv)

命令行中输入 node index.js argument1 argument2,得到的结果如下。

可以看到数组的前两位分别是 Node.js 可执行程序的绝对路径和被执行的 js 文件的绝对路径,剩下的是我们在命令行追加的参数。

认识 cac 包

cac 可以帮助你解析命令行中的参数,创建命令行界面。类似的包还有commander,yargs。

cac 轻量,易用且功能强大。最常用的两个方法是 command和option。command方法可以解析命令行中的命令参数,option 方法可以解析命令行中的选项参数。两者还可以连用,将选项和命令联系起来。

你可以直接使用option方法解析一个选项参数

js 复制代码
import { cac } from "cac";
const cli = cac("cli");

cli.option('--type [type]', 'Choose a project type')
const parsed = cli.parse()
// 打印解析的结果
console.log(JSON.stringify(parsed))

也可以将选项解析和命令解析联系,这样 cac 只会解析 test 命令后面的选项参数。

js 复制代码
import { cac } from "cac";
const cli = cac("cli");
cli
  .command('test', 'Test command')
  .option('--type [type]', 'Choose a project type')
  .action(options => {
    console.log(options)
  })

cli.parse()

Vite 命令行参数的解析

我们打开../src/node/cli.ts这个文件,首先引入 cac 并创建 cli 对象。

接着链式调用 option 方法来解析选项参数。--config --base等这些选项是不和命令挂钩的,所以直接调用 option 方法解析。

接着调用command方法解析和命令挂钩的选项。这些命令分别对应 Vite 提供四种命令:

  1. 不提供命令,serve, dev 启动开发服务器
  2. build 打包
  3. optimize 预构建
  4. preview 预览

我们看和启动开发服务器相关的。

想要启动开发服务器,输入vite既可,不需要在vite后面添加任何命令。command第一个参数中的[root]代表的是项目根目录参数,同vite.config.js中的 root属性。

Vite 还提供了启动开发服务的别名serve和dev,所以vite serve或者vite dev也可以启动开发服务,所以需要调用 alias 方法把这两个命令也加上去。

最后通过action方法获取到命令行解析的结果。

打开 action 方法,该方法接受一个回调函数,回调函数接收的是命令行解析的结果。可以看到 vite 利用这些解析的结果调用 createServer 方法创建了一个服务。

createServer 方法在 src/node/serve/index.ts中。该方法是 Vite 最重要的方法。 下一节我们将继续研究该方法。

相关推荐
锋行天下6 小时前
langgraph全栈项目(一)
前端·人工智能·后端
叼烟扛炮7 小时前
[LangChain] 学习笔记(15):为什么你的重试没用——429、抖动、fallback 与熔断
java·服务器·前端
小码哥0687 小时前
智慧物业系统源码定制:公告发布范围与住户阅读记录设计
前端·javascript·vue.js·物业管理·物业系统·物业软件
泯泷10 小时前
Cloudflare 出手抢 Astro:前端框架之战,底层逻辑变了
前端·javascript·前端框架
狮子座的男孩12 小时前
html+css基础:31、响应式布局(媒体类型,媒体特性,运算符,常用阈值)
前端·css·经验分享·html·响应式布局·媒体类型/特性·常用阈值
鲸鹏芯海微电子科技 (上海) 有限公司12 小时前
手机直连卫星,射频前端到底要解决什么?
前端·智能手机·低轨卫星·謓泽·鲸鹏芯海·毫米波射频·相控阵芯片
Flynt12 小时前
npm run dev --host 有风险?我把 Vite 这个 9.1 分漏洞复现了一遍
前端·vite
AI开源软件12 小时前
Vue3+SpringBoot3 业务配置统一管理:接管、保存与回退怎样保留有效值
java·前端·vue.js·spring boot·vue·ruoyi office
1-1=012 小时前
Vue 脚手架
前端·javascript·vue.js
snow@li13 小时前
node:读取本地文件/静态文件服务器/打开Axure原型/prototype-server
前端·node