一. 先了解一下package.json

每個項目的根目錄都有一個 package.json 文件，定義了這個項目所需要的各種模塊，以及項目的配置信息,下面是一個比較完整的package.json文件

{
 "name": "vue-cli",
 "version": "2.9.3",
 "description": "A simple CLI for scaffolding Vue.js projects.",
 "preferGlobal": true,
 "bin": {
 "vue": "bin/vue",
 "vue-init": "bin/vue-init",
 "vue-list": "bin/vue-list"
 },
 "repository": {
 "type": "",
 "url": ""
 },
 "keywords": [
 ],
 "author": "litongqian",
 "license": "MIT",
 "bugs": {
 "url": ""
 },
 "homepage": "",
 "scripts": {
 "test": "npm run lint && npm run e2e",
 "start": "node index.js"
 },
 "dependencies": {
 "async": "^2.4.0",
 "chalk": "^2.1.0",
 },
 "devDependencies": {
 "chai": "^4.1.2",
 "eslint": "^3.19.0",
 },
 "engines": {
 "node": ">=6.0.0"
 }
}

1. 其中scripts字段

指定了運行腳本命令的npm命令行縮寫，比如start指定了運行 npm run start 時，所要執(zhí)行的命令。

2. bin字段

bin項用來指定各個內(nèi)部命令對應(yīng)的可執(zhí)行文件的位置

"bin": {
 "vue": "bin/vue",
 "vue-init": "bin/vue-init",
 "vue-list": "bin/vue-list"
 },

上面代碼指定， vue 命令對應(yīng)的可執(zhí)行文件為 bin 子目錄下的 vue 。

3. npm link

開發(fā)NPM模塊的時候，有時我們會希望，邊開發(fā)邊試用，比如本地調(diào)試的時候， require('myModule') 會自動加載本機(jī)開發(fā)中的模塊。Node規(guī)定，使用一個模塊時，需要將其安裝到全局的或項目的 node_modules 目錄之中。對于開發(fā)中的模塊，解決方法就是在全局的 node_modules 目錄之中，生成一個符號鏈接，指向模塊的本地目錄。

npm link 就能起到這個作用，會自動建立這個符號鏈接。

請設(shè)想這樣一個場景，你開發(fā)了一個模塊 myModule ，目錄為 src/myModule ，你自己的項目 myProject 要用到這個模塊，項目目錄為 src/myProject 。首先，在模塊目錄（ src/myModule ）下運行 npm link 命令。

src/myModule$ npm link

上面的命令會在NPM的全局模塊目錄內(nèi)，生成一個符號鏈接文件，該文件的名字就是 package.json 文件中指定的模塊名。

/path/to/global/node_modules/myModule -> src/myModule

這個時候，已經(jīng)可以全局調(diào)用 myModule 模塊了。但是，如果我們要讓這個模塊安裝在項目內(nèi)，還要進(jìn)行下面的步驟。

切換到項目目錄，再次運行 npm link 命令，并指定模塊名。

src/myProject$ npm link myModule

上面命令等同于生成了本地模塊的符號鏈接。

然后，就可以在你的項目中，加載該模塊了。

var myModule = require('myModule');

這樣一來， myModule 的任何變化，都可以直接反映在 myProject 項目之中。但是，這樣也出現(xiàn)了風(fēng)險，任何在 myProject 目錄中對 myModule 的修改，都會反映到模塊的源碼中。

如果你的項目不再需要該模塊，可以在項目目錄內(nèi)使用 npm unlink 命令，刪除符號鏈接。

src/myProject$ npm unlink myModule

二. 可執(zhí)行腳本

寫一個簡單的腳本hello

$ mkdir hello #創(chuàng)建一個文件夾

$ cd hello && touch hello #創(chuàng)建命令文件

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

文件的頭部務(wù)必加入#!/usr/bin/env node這行代碼，這里表示使用node作為腳本的解釋程序，node的路徑通過env來查找，可以避免node安裝路徑不一帶來的問題。

打開 /usr/bin/env,可以查看到PATH,操作系統(tǒng)通過路徑找到node

然后，修改 hello 的權(quán)限。

$ chmod 755 hello
$./hello

如果想把 hello 前面的路徑去除，可以將 hello 的路徑加入環(huán)境變量 PATH。但是，另一種更好的做法，是在當(dāng)前目錄下新建 package.json ，寫入下面的內(nèi)容。

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

然后執(zhí)行 npm link 命令。不明白的看上面

$ npm link

執(zhí)行后會產(chǎn)生一個全局的映射關(guān)系,就可以全局使用hello命令了

三.命令行參數(shù)

命令行參數(shù)可以用系統(tǒng)變量 process.argv 獲取。

修改hello腳本

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

其中process為node進(jìn)程中的全局變量，process.argv為一數(shù)組，數(shù)組內(nèi)存儲著命令行的各個部分，argv[0]為node的安裝路徑，argv[1]為主模塊文件路勁，剩下為子命令或參數(shù)，如下：

$ hello a b c

# process.argv的值為[ '/usr/local/bin/node', '/usr/local/bin/hello', 'a', 'b', 'c' ]

腳本可以通過 child_process 模塊新建子進(jìn)程，從而執(zhí)行 Unix 系統(tǒng)命令,修改hello

exec 方法用于執(zhí)行bash命令, exec 方法最多可以接受兩個參數(shù)，第一個參數(shù)是所要執(zhí)行的shell命令，第二個參數(shù)是回調(diào)函數(shù)，該函數(shù)接受三個參數(shù)，分別是發(fā)生的錯誤、標(biāo)準(zhǔn)輸出的顯示結(jié)果、標(biāo)準(zhǔn)錯誤的顯示結(jié)果。

#!/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);
});

執(zhí)行$ hello litongqian

如果我們想查看所有文件,修改hello

var name = process.argv[2];
var exec = require('child_process').exec;

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

執(zhí)行$ hello ls 

hello目錄下有三個文件

四、shelljs 模塊

shell.js 模塊重新包裝了 child_process，調(diào)用系統(tǒng)命令更加方便。它需要安裝后使用。

npm install --save shelljs

然后，改寫腳本。

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

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

五、yargs 模塊

shelljs 只解決了如何調(diào)用 shell 命令，而 yargs 模塊能夠解決如何處理命令行參數(shù)。它也需要安裝。

$ npm install --save yargs

yargs 模塊提供 argv 對象，用來讀取命令行參數(shù)。請看改寫后的 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',
 '/usr/local/bin/hell',
 '--name=tom' ]

yargs 可以上面的結(jié)果改為一個對象，每個參數(shù)項就是一個鍵值對。

六.發(fā)布命令包

通過npm publish進(jìn)行發(fā)布，前提是有npm帳號。如何操作可以查看npm 官方文檔。

本文是通過原生node.js來開發(fā)命令工具，而vue-cli是采用commander.js來簡化命令工具開發(fā),

了解了執(zhí)行流程,去學(xué)習(xí)對應(yīng)的模塊,就很好知道原理了!,本文拋個磚頭

最后:有時我們用到的命令行不是全局安裝的,而是本地安裝的

1. package.json bin字段

bin項用來指定各個內(nèi)部命令對應(yīng)的可執(zhí)行文件的位置。

"name":"someTool",
"bin": {
 "someTool": "./bin/someTool.js"
}

上面代碼指定，someTool 命令對應(yīng)的可執(zhí)行文件為 bin 子目錄下的 someTool.js。

當(dāng)一個項目依賴上面的someTool工具時,同時只是本地安裝

{
 "name": "myproject",
 "devDependencies": {
 "someTool": "latest"
 },
 "scripts": {
 start: 'someTool build' //等同于start: './node_modules/someTool/someTool.js build'

 }
}

npm會尋找這個文件，在 node_modules/.bin/ 目錄下建立符號鏈接。在上面的例子中，someTool.js會建立符號鏈接 npm_modules/.bin/someTool 。由于 node_modules/.bin/ 目錄會在運行時加入系統(tǒng)的PATH變量，因此在運行npm時，就可以不帶路徑，直接通過命令來調(diào)用這些腳本。

因此，像上面這樣的寫法可以采用簡寫。

scripts: { 
 start: './node_modules/someTool/someTool.js build'
}

// 簡寫為

scripts: { 
 start: 'someTool build'
}

所有 node_modules/.bin/ 目錄下的命令，都可以用 npm run [命令] 的格式運行。在命令行下，鍵入 npm run ，然后按tab鍵，就會顯示所有可以使用的命令。

1. npm run

上面代碼中， scripts 字段指定了兩項命令 start ，輸入 npm run-script start 或者 npm run start ，就會執(zhí)行  someTool build 。 npm run 是 npm run-script 的縮寫，一般都使用前者，但是后者可以更好地反應(yīng)這個命令的本質(zhì)。

npm run 命令會自動在環(huán)境變量 $PATH 添加 node_modules/.bin 目錄，所以 scripts 字段里面調(diào)用命令時不用加上路徑，這就避免了全局安裝NPM模塊。

npm run 如果不加任何參數(shù)，直接運行，會列出 package.json 里面所有可以執(zhí)行的腳本命令。

npm內(nèi)置了兩個命令簡寫， npm test 等同于執(zhí)行 npm run test ， npm start 等同于執(zhí)行 npm run start 。

npm run 會創(chuàng)建一個Shell，執(zhí)行指定的命令，并臨時將 node_modules/.bin 加入PATH變量，這意味著本地模塊可以直接運行。

舉例來說，你執(zhí)行ESLint的安裝命令。

$ npm i eslint --save-dev

運行上面的命令以后，會產(chǎn)生兩個結(jié)果。首先，ESLint被安裝到當(dāng)前目錄的 node_modules 子目錄；其次， node_modules/.bin 目錄會生成一個符號鏈接 node_modules/.bin/eslint ，指向ESLint模塊的可執(zhí)行腳本。

然后，你就可以在 package.json 的 script 屬性里面，不帶路徑的引用 eslint 這個腳本。

{
 "name": "Test Project",
 "devDependencies": {
 "eslint": "^1.10.3"
 },
 "scripts": {
 "lint": "eslint ."
 }
}

等到運行 npm run lint 的時候，它會自動執(zhí)行 ./node_modules/.bin/eslint . 。

如果直接運行 npm run 不給出任何參數(shù)，就會列出 scripts 屬性下所有命令。

$ npm run
Available scripts in the user-service package:
 lint
  jshint **.js
 test
 mocha test/

到此,結(jié)束!以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評論