以下是创建命令行工具时常用到的工具，本文旨在能够简单快速了解它们的用途和使用方式，为 [create-react-app 实现](https://github.com/wjcj/blog/issues/29) 一文做铺垫。如希望深入学习可以移步底部👇参考文档链接。 # fs-extra 加强版的 `fs`（node 文件系统模块），主要特性：
1. 支持 [node fs](http://nodejs.cn/api/fs.html#fs_promise_example) 模块所有同名 API，并对所有异步 API 提供了 `promise` 支持（如果未传入回调函数将返回 `promise` ）。 2. 更简单易用的文件系统操作 API👇，并对所有异步 API 提供了 `promise` 支持（如果未传入回调函数将返回 `promise` ），同步方法则直接抛出错误。 ``` js // const fs = require ('fs'); // 不再需要 const fs = require ('fs-extra'); // Async with promises: fs.copy('/tmp/myfile', '/tmp/mynewfile') .then(() => console.log('success!')) .catch(err => console.error(err)) // Async with callbacks: fs.copy('/tmp/myfile', '/tmp/mynewfile', err => { if (err) return console.error(err) console.log('success!') }) // Sync try { fs.copySync('/tmp/myfile', '/tmp/mynewfile') console.log('success!') } catch (err) { console.error(err) } ``` ## API 列表异步方法： - `copy(src, dest[, options][, callback])`: 复制文件或目录。 - `emptyDir(dir[, callback])`: 清空目录。确保一个目录是空的，如果目录非空则删除目录内容。如果目录不存在，就创建一个，目录本身并不是删除。 - `ensureFile(file[, callback])`: 确保文件存在。不存在则创建文件和相关目录，文件存在则不修改。 - `ensureDir(dir[,options][,callback])`: 确保目录存在。不存在则创建。 - `ensureLink(srcPath, destPath[, callback])`: 确保符号链接存在。不存在则创建。 - `ensureSymlink(srcPath, destPath[, type][, callback])`: 确保符号链接存在。目录结构不存在则创建。 - `mkdirp`: `ensureDir` 的别名。 - `mkdirs`: `ensureDir` 的别名。 - `move(src, dest[, options][, callback])`: 移动文件或目录。 - `outputFile(file, data[, options][, callback])`: 输出文件。父目录不存在则创建，`file` 必须是文件路径。 - `outputJson(file, object[, options][, callback])`: 输出 .json 文件，目录不存在则创建。 - `pathExists(file[, callback])`: 路径是否存在。`callback` 参数为 `(err: Error, exists: boolean)`。 - `readJson(file[, options][, callback])`: 读取 JSON 文件，然后将其解析为对象。 - `remove(path[, callback])`: 删除文件或目录。目录可以有内容，若路径不存在，则不做任何事情。 - `writeJson(file, object[, options][, callback])`: 将对象写入 JSON 文件。同步方法：异步同功能 api 名称 + `Sync`：比如 `copySync`、`emptyDirSync` ... # chalk 用于修改终端（terminal）输出的字符串样式，包括字体色、背景色、字体样式（如加粗、下划线等）。常用字体色包括： `black` `red` `green` `yellow` `blue` `magenta` `cyan` `white` ... 常用背景色包括： `bgBlack` `bgRed` `bgGreen` `bgYellow` `bgBlue` `bgMagenta` `bgCyan` `bgWhite` ... ## 示例 ``` js import chalk from 'chalk'; const log = console.log; // 使用模板字符串 log(`${chalk.blue('Hello')} World ${chalk.red('!')}`); // 链式调用 log(chalk.blue.bgRed.bold('Hello world!')); // 嵌套使用 log(chalk.red('Hello', chalk.underline.bgBlue('world') + '!')); ``` # commander `commander` 是 node.js 命令行解决方案。基本使用步骤： 1. 创建 `Command` 对象，得到一个程序（`program`）实例。其中一个程序包含一个或多个命令（`command`），一个命令中可包含多个命令选项（`option`）。 2. 配置命令与命令选项。使用 `.command` 方法配置命令名称、参数、描述信息，使用 `.option` 方法添加命令选项，包括选项名称、参数、描述、默认值等。 3. 注册命令处理函数。通过 `.action` 方法指定命令处理函数，或使用 `.on` 方法监听命令和选项添加自定义函数。 4. 解析用户命令行输入，匹配命令或选项后执行对应的处理函数。 ## 概念 **单命令程序与多命令程序** 单命令程序即程序（`program`）中只包含一个命令，而每个程序本身包含一个顶层命令，故单命令程序不需要额外配置命令。而多命令程序需要配置多个命令，并为每个命令指定独立的处理函数或可执行程序。 **顶级命令、子命令** 以单命令程序 `create-react-app` 为例，在 `create-react-app ` 中，`create-react-app` 就是顶级命令，且是唯一的命令，`` 是一个必填的命令参数。
而多命令程序包含至少两个命令，如 `demo-cli exec