文件路径:VUE 3.0 源码 scripts/dev.js
当我们在命令行敲下 yarn dev 或者 npm run dev 时,会通过 根目录下 package.json 文件中scripts 配置信息找到 scripts/dev.js并开始执行
这个文件都干了哪些事情呢?
我已经注释好了相关Code, 开始慢慢看一下吧:
const execa = require('execa')
// 模糊匹配命令行输入的模块名称跟 packages 目录下模块名称是否一致
const { fuzzyMatchTarget } = require('./utils')
/**
* 解析参数选项
* process.argv.slice(2) 对应 执行命令参数位置(即第3个起始位,对等下例中"-x 3 -y 4 -n 5 -abc --beep=boop foo bar baz"这部分数据) 实例如下:
* node example/parse.js -x 3 -y 4 -n 5 -abc --beep=boop foo bar baz
* args 结果为:{
* _: [ 'foo', 'bar', 'baz' ],
* x: 3,
* y: 4,
* n: 5,
* a: true,
* b: true,
* c: true,
* beep: 'boop'
* }
*/
const args = require('minimist')(process.argv.slice(2))
// 获取 命令行参数中输入的模块名称,默认值:vue
const target = args._.length ? fuzzyMatchTarget(args._)[0] : 'vue'
// 获取 命令行参数中输入的 formats 参数 如 'esm-bundler,cjs' 多个值时中间可用逗号分隔
const formats = args.formats || args.f
// 获取 命令行参数中输入的 sourceMap 参数
const sourceMap = args.sourcemap || args.s
/**
* git rev-parse HEAD --> 获取最新commit id (例如:0996f0ac76188c324831f19089bdd87b9c364cb6)
* commit 值为 commit id 前7位
* commit = *.slice(0, 7) = '0996f0a'
*/
const commit = execa.sync('git', ['rev-parse', 'HEAD']).stdout.slice(0, 7)
/**
* execa
* 第1个参数:string类型 类似在cmd中运行脚本的时候敲的命令
* 第2个参数:string[] 跟第1个参数绑定的命令的相关属性信息
* 第3个参数:execa.Options<string>
* rollup -wc --environment TARGET:[target],FORMATS:umd"
*
* -wc: -w 和 -c 组合,-c 使用配置文件 rollup.config.js 打包 js ,-w 观测源文件变化,并自动重新打包
*
* –environment: 设置传递到文件中的环境变量,可以在JS文件中,通过 process.env 读取
* 这里设置了:process.env.COMMIT、process.env.TARGET 等几个变量
*
*/
execa(
'rollup', [
'-wc',
'--environment',
[
`COMMIT:${commit}`,
`TARGET:${target}`,
`FORMATS:${formats || 'global'}`,
sourceMap ? `SOURCE_MAP:true` : ``
]
/**
* filter(Boolean) 移除所有的 ”false“ 类型元素,Boolean 是个函数
* const a=[1,2,"b",0,{},"",NaN,3,undefined,null,5];
* a.filter(Boolean); // [1,2,"b",{},3,5]
*/
.filter(Boolean)
.join(',')
],
{
/**
* stdio选项用于配置在父进程和子进程之间建立的管道
* 默认情况下,子进程的stdin、stdout和stderr被重定向到相应的 subprocess.stdin, subprocess.stdout, subprocess.stderr 所属ChildProcess对象的流。
* 这相当于 options.stdio = ['inherit','inherit','inherit']
*/
stdio: 'inherit'
}
)