node.js如何製做命令行工具（一）

以前使用過一些全局安裝的NPM包，安裝完以後，能夠經過其提供的命令，完成一些任務。好比Fis3，能夠經過fis3 server start 開啓fis的靜態文件服務，經過fis3 release開啓文件編譯與發佈；還有vue-cli，能夠經過vue init webpack my-project來初始化vue+webpack的項目基礎配置。最近有一個需求，須要寫一個相似vue-cli的NPM包，經過命令行操做實現項目初始配置，因此就查看了相關資料，學習了一下如何使用node來生成本身的命令。

編寫命令行

命令的目標：在當前目錄下開啓一個靜態文件服務,端口號爲8085

1.建立目錄

構成命令的基礎是須要一個命令文件web.js和package.json配置文件，執行如下命令：

$ mkdir node-commander #建立一個文件夾
$ cd node-commander && mkdir bin
$ npm init #初始化package.json文件
$ cd bin && touch web.js  #建立命令文件

2.命令文件

#!/usr/bin/env node

var express = require('express');
var path = process.cwd();

function run(argv) {
    if (argv[0] === '-v' || argv[0] === '--version') {
        console.log('version is 1.0.0');
    }
    else if (argv[0] === '-h' || argv[0] === '--help') {
        console.log('usage:\n');
        console.log('-v --version [show version]')
    }
    else if (argv[0] === '-s' || argv[0] === '--start') {
        var app = new express();
        app.use('/static', express.static(path));
        app.listen(8085, function () {
            console.log('server start at port 8085');
        });
    }
}

run(process.argv.slice(2));　　

 

文件的頭部務必加入#!/usr/bin/env node這行代碼，這裏表示使用node做爲腳本的解釋程序，node的路徑經過env來查找，能夠避免node安裝路徑不一帶來的問題。

其中process爲node進程中的全局變量，process.argv爲一數組，數組內存儲着命令行的各個部分，argv[0]爲node的安裝路徑，argv[1]爲主模塊文件路勁，剩下爲子命令或參數，以下：

node ./bin/web.js a b c
# process.argv的值爲[ '/usr/local/bin/node', '/PATH/web.js', 'a', 'b', 'c' ]

　　

3.命令配置

在package.json文件中添加bin字段：

"bin": { 
    "web": "./bin/web.js"
  },　　

 

bin字段的做用：當安裝npm包時，npm將添加一條命令/usr/local/bin/web，web命令軟鏈接到web.js文件。

 

調試命令行

（1）採用install方法

進入npm包目錄下，執行全局install，根據package.json中bin的配置，爲全局命令建立軟連。

 #  sudo npm install . -g
/usr/local/bin/web -> /usr/local/lib/node_modules/cli-demo/bin/web.js

/usr/local/lib

`-- cli-demo@1.0.0
...

查看web命令

#  which web                
/usr/local/bin/web　　

 

執行web命令

#  web --start
server start at port 8085

 

（2）採用npm link方法

npm link方法建立了兩個軟連，命令與命令文件的軟連，全局包與實際包文件的軟連。

# sudo npm link

/usr/local/bin/web -> /usr/local/lib/node_modules/cli-demo/bin/web.js
/usr/local/lib/node_modules/cli-demo -> /Users/baidu/hwm/home/demos/node/node-commander　　

 

接下來能夠按照方法（1）進行操做了。

發佈命令包

經過npm publish進行發佈，前提是有npm賬號。如何操做能夠查看npm 官方文檔。

 

本文是經過原生node.js來開發命令工具，而vue-cli是採用commander.js來簡化命令工具開發，關於commander.js的使用方法，將在下一篇文章中介紹。