一种编程语言是否易用，很大程度上，取决于开发命令行程序的能力。

Node.js 作为目前最热门的开发工具之一，怎样使用它开发命令行程序，是 Web 开发者应该掌握的技能。

下面就是我在它的基础上扩展的教程，应该是目前最好的解决方案了。

一、可执行脚本

我们从最简单的讲起。

首先，使用 JavaScript 语言，写一个可执行脚本 hello 。

#!/usr/bin/env node
console.log('hello world');

然后，修改 hello 的权限。

$ chmod 755 hello

现在，hello 就可以执行了。

$ ./hello
hello world

如果想把 hello 前面的路径去除，可以将 hello 的路径加入环境变量 PATH。但是，另一种更好的做法，是在当前目录下新建 package.json ，写入下面的内容。

{
 "name": "hello",
 "bin": {
  "hello": "hello"
 }
}

然后执行 npm link 命令。

$ npm link

现在再执行 hello ，就不用输入路径了。

$ hello
hello world

二、命令行参数的原始写法

命令行参数可以用系统变量 process.argv 获取。

下面是一个脚本 hello 。

#!/usr/bin/env node
console.log('hello ', process.argv[2]);

执行时，直接在脚本文件后面，加上参数即可。

$ ./hello tom
hello tom

上面代码中，实际上执行的是 node ./hello tom ，对应的 process.argv 是 ['node', '/path/to/hello', 'tom'] 。

三、新建进程

脚本可以通过 child_process 模块新建子进程，从而执行 Unix 系统命令。

#!/usr/bin/env node
var name = process.argv[2];
var exec = require('child_process').exec;

var child = exec('echo hello ' + name, function(err, stdout, stderr) {
 if (err) throw err;
 console.log(stdout);
});

用法如下。

$ ./hello tom
hello tom

四、shelljs 模块

shelljs 模块重新包装了 child_process，调用系统命令更加方便。它需要安装后使用。

npm install --save shelljs

然后，改写脚本。

#!/usr/bin/env node
var name = process.argv[2];
var shell = require("shelljs");

shell.exec("echo hello " + name);

上面代码是 shelljs 的本地模式，即通过 exec 方法执行 shell 命令。此外还有全局模式，允许直接在脚本中写 shell 命令。

require('shelljs/global');

if (!which('git')) {
 echo('Sorry, this script requires git');
 exit(1);
}

mkdir('-p', 'out/Release');
cp('-R', 'stuff/*', 'out/Release');

cd('lib');
ls('*.js').forEach(function(file) {
 sed('-i', 'BUILD_VERSION', 'v0.1.2', file);
 sed('-i', /.*REMOVE_THIS_LINE.*\n/, '', file);
 sed('-i', /.*REPLACE_LINE_WITH_MACRO.*\n/, cat('macro.js'), file);
});
cd('..');

if (exec('git commit -am "Auto-commit"').code !== 0) {
 echo('Error: Git commit failed');
 exit(1);
}

五、yargs 模块

shelljs 只解决了如何调用 shell 命令，而 yargs 模块能够解决如何处理命令行参数。它也需要安装。

$ npm install --save yargs

yargs 模块提供 argv 对象，用来读取命令行参数。请看改写后的 hello 。

#!/usr/bin/env node
var argv = require('yargs').argv;

console.log('hello ', argv.name);

使用时，下面两种用法都可以。

$ hello --name=tom
hello tom

$ hello --name tom
hello tom

也就是说，process.argv 的原始返回值如下。

$ node hello --name=tom
[ 'node',
 '/path/to/myscript.js',
 '--name=tom' ]

yargs 可以上面的结果改为一个对象，每个参数项就是一个键值对。

var argv = require('yargs').argv;

// $ node hello --name=tom
// argv = {
//  name: tom
// };

如果将 argv.name 改成 argv.n，就可以使用一个字母的短参数形式了。

$ hello -n tom
hello tom

可以使用 alias 方法，指定 name 是 n 的别名。

#!/usr/bin/env node
var argv = require('yargs')
 .alias('n', 'name')
 .argv;

console.log('hello ', argv.n);

这样一来，短参数和长参数就都可以使用了。

$ hello -n tom
hello tom
$ hello --name tom
hello tom

argv 对象有一个下划线（_）属性，可以获取非连词线开头的参数。

#!/usr/bin/env node
var argv = require('yargs').argv;

console.log('hello ', argv.n);
console.log(argv._);

用法如下。

$ hello A -n tom B C
hello tom
[ 'A', 'B', 'C' ]

六、命令行参数的配置

yargs 模块还提供3个方法，用来配置命令行参数。

1. demand：是否必选
2. default：默认值
3. describe：提示

#!/usr/bin/env node
var argv = require('yargs')
 .demand(['n'])
 .default({n: 'tom'})
 .describe({n: 'your name'})
 .argv;

console.log('hello ', argv.n);

上面代码指定 n 参数不可省略，默认值为 tom，并给出一行提示。

options 方法允许将所有这些配置写进一个对象。

#!/usr/bin/env node
var argv = require('yargs')
 .option('n', {
  alias : 'name',
  demand: true,
  default: 'tom',
  describe: 'your name',
  type: 'string'
 })
 .argv;

console.log('hello ', argv.n);

有时，某些参数不需要值，只起到一个开关作用，这时可以用 boolean 方法指定这些参数返回布尔值。

#!/usr/bin/env node
var argv = require('yargs')
 .boolean(['n'])
 .argv;

console.log('hello ', argv.n);

上面代码中，参数 n 总是返回一个布尔值，用法如下。

$ hello
hello false
$ hello -n
hello true
$ hello -n tom
hello true

boolean 方法也可以作为属性，写入 option 对象。

#!/usr/bin/env node
var argv = require('yargs')
 .option('n', {
  boolean: true
 })
 .argv;

console.log('hello ', argv.n);

七、帮助信息

yargs 模块提供以下方法，生成帮助信息。

1. usage：用法格式
2. example：提供例子
3. help：显示帮助信息
4. epilog：出现在帮助信息的结尾

#!/usr/bin/env node
var argv = require('yargs')
 .option('f', {
  alias : 'name',
  demand: true,
  default: 'tom',
  describe: 'your name',
  type: 'string'
 })
 .usage('Usage: hello [options]')
 .example('hello -n tom', 'say hello to Tom')
 .help('h')
 .alias('h', 'help')
 .epilog('copyright 2015')
 .argv;

console.log('hello ', argv.n);

执行结果如下。

$ hello -h

Usage: hello [options]

Options:
 -f, --name your name [string] [required] [default: "tom"]
 -h, --help Show help [boolean]

Examples:
 hello -n tom say hello to Tom

copyright 2015

八、子命令

yargs 模块还允许通过 command 方法，设置 Git 风格的子命令。

#!/usr/bin/env node
var argv = require('yargs')
 .command("morning", "good morning", function (yargs) {
  console.log("Good Morning");
 })
 .command("evening", "good evening", function (yargs) {
  console.log("Good Evening");
 })
 .argv;

console.log('hello ', argv.n);

用法如下。

$ hello morning -n tom
Good Morning
hello tom

可以将这个功能与 shellojs 模块结合起来。

#!/usr/bin/env node
require('shelljs/global');
var argv = require('yargs')
 .command("morning", "good morning", function (yargs) {
  echo("Good Morning");
 })
 .command("evening", "good evening", function (yargs) {
  echo("Good Evening");
 })
 .argv;

console.log('hello ', argv.n);

每个子命令往往有自己的参数，这时就需要在回调函数中单独指定。回调函数中，要先用 reset 方法重置 yargs 对象。

#!/usr/bin/env node
require('shelljs/global');
var argv = require('yargs')
 .command("morning", "good morning", function (yargs) { 
  echo("Good Morning");
  var argv = yargs.reset()
   .option("m", {
    alias: "message",
    description: "provide any sentence"
   })
   .help("h")
   .alias("h", "help")
   .argv;

  echo(argv.m);
 })
 .argv;

用法如下。

$ hello morning -m "Are you hungry?"
Good Morning
Are you hungry?

九、其他事项

（1）返回值

根据 Unix 传统，程序执行成功返回 0，否则返回 1 。

if (err) {
 process.exit(1);
} else {
 process.exit(0);
}

（2）重定向

Unix 允许程序之间使用管道重定向数据。

$ ps aux | grep 'node'

脚本可以通过监听标准输入的data 事件，获取重定向的数据。

process.stdin.resume();
process.stdin.setEncoding('utf8');
process.stdin.on('data', function(data) {
 process.stdout.write(data);
});

下面是用法。

$ echo 'foo' | ./hello
hello foo

（3）系统信号

操作系统可以向执行中的进程发送信号，process 对象能够监听信号事件。

process.on('SIGINT', function () {
 console.log('Got a SIGINT');
 process.exit(0);
});

发送信号的方法如下。

$ kill -s SIGINT [process_id]

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# nodejs  # 命令行  # 执行命令行  # 命令行程序  # 浅谈node.js 命令行工具(cli)  # Node.js 使用命令行工具检查更新  # 手把手教你如何使用nodejs编写cli命令行  # 详解Node.js如何开发命令行工具  # node通过npm写一个cli命令行工具  # 深入理解nodejs搭建静态服务器(实现命令行)  # 详解用Node.js写一个简单的命令行工具  # 如何从0开始用node写一个自己的命令行程序  # 如何利用nodejs实现命令行游戏  # 可以用  # 重定向  # 可以通过  # 回调  # 可执行  # 就可以  # 自己的  # 返回值  # 的是  # 是一个  # 是在  # 我在  # 最好的  # 不需要  # 基础上  # 出现在  # 布尔值  # 两种  # 下划线 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Laravel如何实现数据导出到PDF_Laravel使用snappy生成网页快照PDF【方案】  Windows10如何更改计算机工作组_Win10系统属性修改Workgroup  网站制作大概多少钱一个,做一个平台网站大概多少钱？  laravel怎么用DB facade执行原生SQL查询_laravel DB facade原生SQL执行方法  Laravel如何实现图片防盗链功能_Laravel中间件验证Referer来源请求【方案】  简单实现jsp分页  INTERNET浏览器怎样恢复关闭标签页_INTERNET浏览器标签恢复快捷键与方法【指南】  ,怎么在广州志愿者网站注册？  Firefox Developer Edition开发者版本入口  Laravel怎么配置不同环境的数据库_Laravel本地测试与生产环境动态切换【方法】  Laravel如何使用Eloquent进行子查询  如何在宝塔面板创建新站点？  jQuery 常见小例汇总  Laravel如何自定义分页视图？（Pagination示例）  桂林网站制作公司有哪些,桂林马拉松怎么报名？  制作旅游网站html,怎样注册旅游网站？  中国移动官方网站首页入口 中国移动官网网页登录  Laravel如何为API生成Swagger或OpenAPI文档  如何利用DOS批处理实现定时关机操作详解  网站视频制作书签怎么做,ie浏览器怎么将网站固定在书签工具栏？  javascript日期怎么处理_如何格式化输出  Win11怎么修改DNS服务器 Win11设置DNS加速网络【指南】  JavaScript如何实现音频处理_Web Audio API如何工作？  Laravel Eloquent访问器与修改器是什么_Laravel Accessors & Mutators数据处理技巧  Laravel Seeder填充数据教程_Laravel模型工厂Factory使用  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  PHP 500报错的快速解决方法  Laravel怎么定时执行任务_Laravel任务调度器Schedule配置与Cron设置【教程】  Laravel定时任务怎么设置_Laravel Crontab调度器配置  如何快速上传自定义模板至建站之星？  如何在沈阳梯子盘古建站优化SEO排名与功能模块？  laravel服务容器和依赖注入怎么理解_laravel服务容器与依赖注入解析  Laravel怎么实现微信登录_Laravel Socialite第三方登录集成  Laravel如何配置和使用缓存？（Redis代码示例）  Laravel如何配置Horizon来管理队列？（安装和使用）  Laravel如何与Inertia.js和Vue/React构建现代单页应用  googleplay官方入口在哪里_Google Play官方商店快速入口指南  HTML5段落标签p和br怎么选_文本排版常用标签对比【解答】  网页制作模板网站推荐,网页设计海报之类的素材哪里好？  网站制作软件免费下载安装,有哪些免费下载的软件网站？  南京网站制作费用,南京远驱官方网站？  如何制作一个表白网站视频,关于勇敢表白的小标题？  Laravel如何实现邮箱地址验证功能_Laravel邮件验证流程与配置  网站制作公司哪里好做,成都网站制作公司哪家做得比较好，更正规？  Laravel怎么自定义错误页面_Laravel修改404和500页面模板  怎么用AI帮你设计一套个性化的手机App图标？  武汉网站设计制作公司,武汉有哪些比较大的同城网站或论坛，就是里面都是武汉人的？  Laravel如何处理文件上传_Laravel Storage门面实现文件存储与管理  Linux系统运维自动化项目教程_Ansible批量管理实战  如何用y主机助手快速搭建网站？