Home

node 命令行应用 与 npm 包发布

先讲讲 Npm

NPM

NPM是随NodeJS一起安装的包管理工具, 能解决NodeJS代码部署上的很多问题, 以下是常见的使用场景:

让用户从NPM服务器下载别人编写的命令程序到本地使用 允许用户从NPM服务器下载并安装别人编写的命令行程序到本地使用 允许用户将自己编写的包或命令行程序上传到NPM服务器供别人使用

安装

新版的nodejs已经竟成了NPM,所以NPM也一并安装上了.检查是否成功安装NPM,可以在终端输入以下命令来测试是否安装成功

npm -v

更新NPM版本的命令:

sudo npm install npm -g

使用

npm安装nodejs模块语法格式:

npm install

全局安装与本地安装

npm的包安装分为本地安装 (local) 和 全局安装 (global) 两种

npm install express //本地安装
npm install express -g //全局安装

两者的区别

本地安装:

将安装包放在 ./node_modules 下(运行 npm 命令时所在的目录),如果没有 node_modules 目录,会在当前执行 npm 命令的目录下生成 node_modules 目录。 可以通过 require() 来引入本地安装的包。

全局安装:

将安装包放在 /usr/local 下。 可以直接在命令行里使用。 不能通过 require() 来引入本地安装的包。

可以用以下命令来查看所有全局安装的模块:

npm ls -g

Package.json 属性说明

官网属性列表 中文——属性解释

卸载模块 可以使用以下命令来卸载Nodejs

npm uninstall express //卸载该express模块
npm ls // 查看是否成功卸载

更新模块 可以使用以下命令来更新模块

npm update express

搜索模块 使用以下命令来搜索模块

npm search express

创建模块 生成package.json

注册一个npm账户

npm adduser

Username :
Password:
Email:

发布模块

npm publish

版本号 使用NPM下载和发布代码时都会接触到版本号。NPM使用语义版本号来管理代码, 语义版本号分为X.Y.Z三位,分别代表主版本号、次版本号和补丁版本号。当代码变更时,版本号按以下原则更新。

如果只是修复bug,需要更新Z位。 如果是新增了功能,但是向下兼容,需要更新Y位。 如果有大变动,向下不兼容,需要更新X位。 版本号有了这个保证后,在申明第三方包依赖时,除了可依赖于一个固定版本号外,还可依赖于某个范围的版本号。例如”argv”: “0.0.x”表示依赖于0.0.x系列的最新版argv。

NPM常用命令

再来说说 命令行 cli

拿一个简单的 github 项目来说

wifi-password-cli

#!/usr/bin/env node
'use strict';
const meow = require('meow');
const wifiPassword = require('wifi-password');

const cli = meow(`
	Usage
	  $ wifi-password [network-name]
	Example
	  $ wifi-password
	  unicorns
	  $ wifi-password foo-network
	  foosecretpassword
`);

wifiPassword(cli.input[0])
	.then(console.log)
	.catch(err => {
		if (err.message === `Your network doesn't have a password`) {
			console.error(err.message);
			process.exit(1);
		}

		throw err;
	});

meow

meow 是 简单的命令行帮助程序

wifi-password-cli的使用

安装

npm install -g wifi-password-cli

使用

$ wifi-password --help

  Usage
    $ wifi-password [network-name]

  Example
    $ wifi-password
    unicorns
    $ wifi-password foo-network
    foosecretpassword

可以看到正是上面代码的 meow{} 的内容

- 那么可以看出,全局安装的部分由npm完成

- package.json里面,发布相关部分也要注意⚠️,尤其是bin

- 那么最后 命令行 cli.js编写调用->主程序->上文就是 wifi-password,和名字

进阶 命令行 commander

是由 expresskoa 项目 开发者之一的 tj

Ruby 移植 javascript项目 commander