九、其他事项

最后更新于:2022-04-01 02:00:00

(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] ~~~
';

八、子命令

最后更新于:2022-04-01 01:59:58

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? ~~~
';

七、帮助信息

最后更新于:2022-04-01 01:59:56

yargs 模块提供以下方法,生成帮助信息。 > * usage:用法格式 > * example:提供例子 > * help:显示帮助信息 > * 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 ~~~
';

六、命令行参数的配置

最后更新于:2022-04-01 01:59:54

yargs 模块还提供3个方法,用来配置命令行参数。 > * demand:是否必选 > * default:默认值 > * 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 模块

最后更新于:2022-04-01 01:59:51

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 ~~~ 如果将 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' ] ~~~
';

四、shelljs 模块

最后更新于:2022-04-01 01:59:49

[shelljs](https://www.npmjs.com/package/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); } ~~~
';

三、新建进程

最后更新于:2022-04-01 01:59:47

脚本可以通过 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 ~~~
';

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

最后更新于:2022-04-01 01:59:44

命令行参数可以用系统变量 process.argv 获取。 ~~~ #!/usr/bin/env node console.log('hello ', process.argv[2]); ~~~ 执行时,直接在脚本文件后面,加上参数即可。 ~~~ $ ./hello tom hello tom ~~~
';

一、可执行脚本

最后更新于:2022-04-01 01:59:42

我们从最简单的讲起。 首先,使用 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 ~~~
';

前言

最后更新于:2022-04-01 01:59:40

> 原文:http://www.ruanyifeng.com/blog/2015/05/command-line-with-node.html > 作者:阮一峰 一种编程语言是否易用,很大程度上,取决于开发命令行程序的能力。 Node.js 作为目前最热门的开发工具之一,怎样使用它开发命令行程序,是 Web 开发者应该掌握的技能。 ![terminal-node](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2015-08-05_55c1819ecf909.png) 最近,Npm的网志有一组[系列文章](http://blog.npmjs.org/post/118810260230/building-a-simple-command-line-tool-with-npm),我觉得写得非常好。下面就是我在它的基础上扩展的教程,应该是目前最好的解决方案了。
';