1

vue create my-vue-project 执行后发生了什么,顺序执行

  • 【系统】系统定位到bin/vue.js文件,通过node bin/vue.js create my-project来执行该文件;
  • 【vue.js】bin/vue.js利用commander来定义命令选项create,将create命令匹配到create方法(lib/create.js),执行该方法;
  • 【create.js】lib/create.js使用Inquirer.js来询问用户,进行项目配置;
  • 【Creator.js】根据用户配置生成package.json文件(基础信息,从项目配置中注入对应的开发依赖devDependencies);
  • 【Creator.js】执行npm i来安装依赖;(PS: 这里封装了常用的npm操作,可以直接拷贝到自己项目中使用)
  • 【Creator.js】加载vue-cli插件(@vue/cli-service是第一个被执行的插件);
  • 【Generator.js】执行所有插件(执行cli-service插件会生成项目文件结构);
  • 【Creator.js】生成README.md文件;

上面就是create命令的基本执行过程,如果我们想扩展create方法,例如按照我们的定义的模板生成目录结构,可以新建一个插件(generator,可以参考cli-service),在插件里生成自定义的目录结构即可。

一,命令执行过程

当你在控制台敲下npm -v并回车的时候,到底发生了什么?

我们先来看看npm这个命令在哪。通过执行which npm,(不了解which命令的同学可以参考这里:linux命令之which),可以看到,npm命令的可执行文件在/usr/local/bin/npm,打开文件夹一看,是个替身,右键“显示原身”(Mac用户的方法,其他用户请搜索“软链接”),就能定位到该命令在哪:/usr/local/lib/node_modules/npm/bin/npm-cli.js,看到是js代码相信大家已经松了一口气,我们先不急着看npm-cli.js里面的源,我们先思考一个问题:

Q1:系统是怎么找到npm这个这个命令的可执行文件的?

A1:了解which命令的同学都知道,which命令会按照PATH变量中的路径顺序来查找可执行文件。执行echo $PATH可以打印出该变量内容:/usr/local/bin:/usr/bin:/bin(例如这是我的部分内容,目录间用‘:’分隔),所以系统会先在/usr/local/bin下面找npm执行文件,/usr/local/bin/npm链接到/usr/local/lib/node_modules/npm/bin/npm-cli.js。所以调用npm命令相当于执行npm-cli.js

总的来说:在控制台执行命令时,系统会先去环境路径(PATH)中找到可执行文件,然后执行该文件

那么,有同学好奇:

Q2:系统又是怎么执行这些文件(例如上面的npm-cli)的呢?

A2:打开npm-cli.js文件,我们能看到的第一行代码就是:#!/usr/bin/env node,这行代码到底有什么用呢?具体可参考:stackoverflow - #!/usr/bin/env到底有什么用?,大致意思是告知系统用什么解释程序来执行该文件,例如#!/usr/bin/env node就是告知系统,npm-cli.js要用node来执行。因此npm -v相当于node /usr/local/lib/node_modules/npm/bin/npm-cli.js -v

$ node /usr/local/lib/node_modules/npm/bin/npm-cli.js -v
6.4.1

二,npm包打造cli的原理

了解完命令执行过程之后,我们就可以打造自己的cli命令了。

①先编写my-cli.js文件:

#!/usr/bin/env node
console.log('Hello cli!');

②在/usr/local/bin下(或者PATH里的任意路径下)创建软链接:

ln -s my-cli.js my-cli

③给my-cli命令添加可执行权限:(若不添加权限,会报错bash: /usr/local/bin/my-cli: Permission denied)

chmod 777 my-cli

④验证效果:

$ my-cli
Hello cli!

在上面的基础上,我们虽然能打造自己的命令,但是这个命令要想给团队使用,就需要每个人都拷贝my-cli.js文件,创建软链接,添加可执行权限,非常繁琐。怎么将自己的命令分发出去给别人使用呢?

我们再往前探索一步,一起打造一个基于npm分发的命令。

我们在下载使用一个npm模块命令的时候,我们会这样:

npm install -g @vue/cli
vue create my-project

全局安装vue-cli这个npm模块之后,我们全局新增了vue命令,这背后到底发生了什么?是npm install帮我们把上面提到的②③步自动执行了(如有错误,欢迎指出)。既然npm已经帮我们完成这些简单但是繁琐的脚本操作,那我们只需要按照npm的规范来配置一下代码即可。流程比较简单,请参考:通过npm包来制作命令行工具的原理

总结一下开发过程:

  1. npm init新建npm模块目录;
  2. 开发命令(例如上面的my-cli.js);
  3. package.json中添加bin字段(bin: { "my-cli": "./my-cli.js" });
  4. 发布npm;
  5. 全局安装即可使用my-cli;

三,VUE-CLI中核心库

vue-cli源码 了解怎么优雅地实现一个cli。

介绍几个vue-cli里面用到的几个库:

  1. commander - 命令行参数解析库;
  2. Inquirer.js - 命令行常用交互形式集合(问答,选择...);
  3. chalk - 在命令行样式美化;
  4. ora - 命令行loader;

commander几乎是开发cli必不可少的工具,原理(参考commander源码),基本使用方法如下:

#!/usr/bin/env node
var program = require('commander');

program
  .version('0.1.0')
  .option('-p, --peppers', 'Add peppers')
  .option('-P, --pineapple', 'Add pineapple')
  .option('-b, --bbq-sauce', 'Add bbq sauce')
  .option('-c, --cheese [type]', 'Add the specified type of cheese [marble]', 'marble')
  .parse(process.argv);

核心流程如下:

1. 通过option定义收集命令的功能选项;

2. parse解析命令参数(有process获得);

3. 由命令参数去匹配前面收集到的功能选项,执行前面的方法(将参数传入);

/**
 * Parse `argv`, settings options and invoking commands when defined.
 *
 * @param {Array} argv
 * @return {Command} for chaining
 * @api public
 */

Command.prototype.parse = function(argv) {
  // implicit help
  if (this.executables) this.addImplicitHelpCommand();

  // store raw args
  this.rawArgs = argv;

  // guess name
  this._name = this._name || basename(argv[1], '.js');

  // github-style sub-commands with no sub-command
  if (this.executables && argv.length < 3 && !this.defaultExecutable) {
    // this user needs help
    argv.push('--help');
  }

  // process argv
  var parsed = this.parseOptions(this.normalize(argv.slice(2)));
  var args = this.args = parsed.args;

  var result = this.parseArgs(this.args, parsed.unknown);

  // executable sub-commands
  var name = result.args[0];

  var aliasCommand = null;
  // check alias of sub commands
  if (name) {
    aliasCommand = this.commands.filter(function(command) {
      return command.alias() === name;
    })[0];
  }

  if (this._execs[name] && typeof this._execs[name] !== 'function') {
    return this.executeSubCommand(argv, args, parsed.unknown);
  } else if (aliasCommand) {
    // is alias of a subCommand
    args[0] = aliasCommand._name;
    return this.executeSubCommand(argv, args, parsed.unknown);
  } else if (this.defaultExecutable) {
    // use the default subcommand
    args.unshift(this.defaultExecutable);
    return this.executeSubCommand(argv, args, parsed.unknown);
  }

  return result;
};

原文参考: cli原理解析


万年打野易大师
1.5k 声望1.1k 粉丝