egg源码浅析一npm init egg --type=simple

要egg文档最开始的时候，有这样的几条命令：

我们推荐直接使用脚手架，只需几条简单指令，即可快速生成项目:

$ mkdir egg-example && cd egg-example

$ npm init egg --type=simple

$ npm i

其中的 npm init egg --type=simple 命令为什么能够生成egg项目的基本构架呢？

一、npm init命令

根据 https://www.npmjs.cn/cli/init/ 官网的解释:

　按照上面的解释，npm init egg 相当于 npx create-egg 并且执行create-egg的bin.

二、npx命令

　　npx相当于npm，但npx会把node_modules/.bin/目录加入环境变量.

　　这里讲怎么用：http://www.ruanyifeng.com/blog/2019/02/npx.html

也就是说，npm init egg 相当于执行 npx create-egg，而npx create-egg命令会下载create-egg库，再执行里面的bin(package.json里的bin字段)。

　　另外，npx create-egg 会在当前目录/node_modules目录下查找有没有create-egg，没有就会下载到临时目录，最后删除。

三、下载create-egg库

　　create-egg的目录结构如下，package.json里没有main，却有bin字段，bin字段值是./bin/create-egg.js。当安装create-egg的时，会在当前安装目录下的node_modules/.bin/目录放置create-egg作为可执行文件。

　　

　　create-egg.js文件里只有一行代码：

console.log('--------i am create-egg');

require('egg-init/bin/egg-init');

　　再来看egg-init库。

四、egg-init

#!/usr/bin/env node

'use strict';

const co = require('co');

const Command = require('..');

co(function* () {

  console.log('process.cwd:', process.cwd());

  console.log('process.argv.slice:', process.argv.slice(2));

  // process.cwd: /Users/demon/Desktop/test/createeggtest

  // process.argv.slice: [ '--type=simple' ]

  yield new Command().run(process.cwd(), process.argv.slice(2));

}).catch(err => {

  console.error(err.stack);

  process.exit(1);

});

process.cwd是命令执行的所有文件夹，argv.slice(2)之后是--type=simple字符串。

之后，向 https://registry.npmjs.org/egg-init-config/latest请求，获取响应：

{

    "name":"egg-init-config",

    "version":"1.5.0",

    "description":"egg init boilerplate config",

    "config":{

        "boilerplate":{

            "simple":{

                "package":"egg-boilerplate-simple",

                "description":"Simple egg app boilerplate"

            },

            "microservice":{

                "package":"egg-boilerplate-microservice",

                "description":"Microservice app boilerplate based on egg"

            },

            "sequelize":{

                "package":"egg-boilerplate-sequelize",

                "description":"egg app with sequelize"

            },

            "ts":{

                "package":"egg-boilerplate-ts",

                "description":"Simple egg && typescript app boilerplate"

            },

            "empty":{

                "package":"egg-boilerplate-empty",

                "description":"Empty egg app boilerplate"

            },

            "plugin":{

                "package":"egg-boilerplate-plugin",

                "description":"egg plugin boilerplate"

            },

            "framework":{

                "package":"egg-boilerplate-framework",

                "description":"egg framework boilerplate"

            }

        }

    },

    ...

}

根据得到的响应，匹配--type=simple，得到package:

"simple":{

    "package":"egg-boilerplate-simple",

    "description":"Simple egg app boilerplate"

},

得到egg-boilerplate-simple，再次向 https://registry.npmjs.org/egg-boilerplate-simple/latest请求，

{

  "name": "egg-boilerplate-simple",

  "version": "3.3.1",

 　...
  "dist": {

    "integrity": "sha512-zj8ES0n7lAXGMWornOOY1n0Q+skX0wA9hjl40QsTa3SS5FcExVoEWQ52kCeT+bnvNKEL8fiOD9S2J4J9wDjbKg==",

    "shasum": "c56c87c1f2b705a9247b0903958aac76d141b2c6",

    "tarball": "https://registry.npmjs.org/egg-boilerplate-simple/-/egg-boilerplate-simple-3.3.1.tgz",

    "fileCount": 31,

    "unpackedSize": 19461,

    "npm-signature": "-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJcv91nCRA9TVsSAnZWagAAyZ8P/RyW3+wL32xjrVTDNDlQ\nBuxafQ/J5gGtG3tlwkqG184G3hSoceY0qSiIKv60sVsOtMZfJUZd5znNAGro\n/pSmKW23jfA1Xw49HGMfT++6ZQ+PoZ8l13p5zwjIHs10+d/RAx1hi3xm6xiA\nTjfKQXCUbt7aLYGQgpX155ZD/DcvI+VUWTw6fc5pJg7NXkOFDSwo+TaxsxHX\nw7iom89bQICaK6mBybDMI2+gkeMvSuKPnBiI8TuSCrgoGnkfXWF6Hd6ZL76O\nG3uA2LqYNqELUsPyoD97NL17vOayGbP8xJdn+l9dUQF8e4oD9m6gjEz0uTKO\nr3zxjx8X8HrjaJo2CJbYrOl5+zNYrM4dTt/oY5zU56aoOesCcht8FxrcaHNl\n/fVxIH8YgUzv3ZbwGRAb5G/NwF5GwtfmyGtkiJ/9i5awB+QLezC7Hkl4ZMGZ\nnblIDGnPGF+zY7Epg2FPDQgB/SDurENiAFiSPBX7jbi3AH9hfABHeH4NeYTi\n5j+NGtv2QY6eqffxrQpg7Vibe5nbRKCPkLqcqy0BsPixSHe7RvnNMulxX609\nJUCrz5M9YNQEAkDckomD5QDzWzTFaPEWqUUjohfgPheIi2KJ9w0jU2QV6pxG\nh3MbZNyLYHw1cXUEkupiNqSVwP7NGbDcH5t5uQGrSS4j4RdpxrSonNaB0You\nZdaq\r\n=Q83Q\r\n-----END PGP SIGNATURE-----\r\n"

  },

　　...

}

拿到dist.tarball字段的值，下载到临时目录下的egg-init-boilerplate目录并解压:

const saveDir = path.join(os.tmpdir(), 'egg-init-boilerplate');

  yield compressing.tgz.uncompress(response.res, saveDir);

之后，进入saveDir/package/boilerplate目录，boilerplate目录内容如下

之后就是把这个目录的内容拷贝到目标目录下，当然会把_前缀去掉：

const to = path.join(targetDir, this.replaceTemplate(this.fileMapping[file] || file, locals));

const content = fs.readFileSync(from);

this.log('write to %s', to);

// check if content is a text file

const result = isTextOrBinary.isTextSync(from, content)

   ? this.replaceTemplate(content.toString('utf8'), locals)

   : content;

mkdirp.sync(path.dirname(to));

fs.writeFileSync(to, result);

这就是npm init egg --type=simple内容的由来了。