NPM基础小结

timg.jpeg

nodejs的出现,可以算是前端里程碑式的一个事件,它让前端攻城狮们摆脱了浏览器的束缚,踏上了一个更加宽广的舞台。前端的可能性,从此更加具有想象空间。

随着一系列基于nodejs的应用/工具的出现,工作中与nodejs打交道的机会越来越多。无论在node应用的开发,还是使用中,包管理都扮演着一个很重要的作用。NPM(node package manager),作为node的包管理工具,极大地便利了我们的开发工作,很有必要了解一下。

NPM是什么

NPM(node package manager),通常称为node包管理器。顾名思义,它的主要功能就是管理node包,包括:安装、卸载、更新、查看、搜索、发布等。
npm的背后,是基于couchdb的一个数据库,详细记录了每个包的信息,包括作者、版本、依赖、授权信息等。它的一个很重要的作用就是:将开发者从繁琐的包管理工作(版本、依赖等)中解放出来,更加专注于功能的开发。
npm官网:https://npmjs.org/
npm官方文档:https://npmjs.org/doc/README.html

我们需要了解什么

npm的安装、卸载、升级、配置
npm的使用:package的安装、卸载、升级、查看、搜索、发布
npm包的安装模式:本地 vs 全局
package.json:包描述信息
package版本:常见版本声明形式

npm包安装模式

在具体介绍npm包的管理之前,我们首先得来了解一下npm包的两种安装模式。

本地安装 vs 全局安装(重要)
node包的安装分两种:本地安装、全局安装。两者的区别如下,后面会通过简单例子说明
本地安装:package会被下载到当前所在目录,也只能在当前目录下使用。
全局安装:package会被下载到到特定的系统目录下,安装的package能够在所有目录下使用。

npm install pkg - 本地安装

运行如下命令,就会在当前目录下安装grunt-cli(grunt命令行工具)

npm install grunt-cli

安装结束后,当前目录下回多出一个node_modules
目录,grunt-cli就安装在里面。同时注意控制台输出的信息:

[grunt-cli@0.1.9](mailto:grunt-cli@0.1.9) node_modules/grunt-cli
├── [resolve@0.3.1](mailto:resolve@0.3.1)
├── [nopt@1.0.10](mailto:nopt@1.0.10) ([abbrev@1.0.4](mailto:abbrev@1.0.4))
└── [findup-sync@0.1.2](mailto:findup-sync@0.1.2) ([lodash@1.0.1](mailto:lodash@1.0.1), [glob@3.1.21](mailto:glob@3.1.21))

简单说明一下:

grunt-cli@0.1.9:当前安装的packagegrunt-cli,版本为0.19
node_modules/grunt-cli:安装目录
resolve@0.3.1:依赖的包有resolvenoptfindup-sync,它们各自的版本、依赖在后面的括号里列出来

npm install -g pkg- 全局安装

上面已经安装了grunt-cli,然后你跑到其他目录下面运行如下命令

grunt

果断提示你grunt命令不存在,为什么呢?因为上面只是进行了本地安装,grunt命令只能在对应安装目录下使用。

-bash: grunt: command not found

如果为了使用grunt命令,每到一个目录下都得重新安装一次,那不抓狂才怪。肿么办呢?
很简单,采用全局安装就行了,很简单,加上参数-g
就可以了

npm install -g grunt-cli

于是,在所有目录下都可以无压力使用grunt命令了。这个时候,你会注意到控制台输入的信息有点不同。主要的区别在于安装目录,现在变成了

/usr/local/lib/node_modules/grunt-cli
,/usr/local/lib/node_modules/

也就是之前所说的全局安装目录啦。

[grunt-cli@0.1.9](mailto:grunt-cli@0.1.9) /usr/local/lib/node_modules/grunt-cli
├── [resolve@0.3.1](mailto:resolve@0.3.1)
├── [nopt@1.0.10](mailto:nopt@1.0.10) ([abbrev@1.0.4](mailto:abbrev@1.0.4))
└── [findup-sync@0.1.2](mailto:findup-sync@0.1.2) ([lodash@1.0.1](mailto:lodash@1.0.1), [glob@3.1.21](mailto:glob@3.1.21))

npm包管理

npm的包管理命令是使用频率最高的,所以也是我们需要牢牢记住并熟练使用的。其实无非也就是几个动作:安装、卸载、更新、查看、搜索、发布等。
安装最新版本的grunt-cli

npm install grunt-cli

安装0.1.9版本的grunt-cli

npm install [grunt-cli@"0.1.9](mailto:grunt-cli@%220.1.9)"

通过package.json进行安装
如果我们的项目依赖了很多package,一个一个地安装那将是个体力活。我们可以将项目依赖的包都在package.json这个文件里声明,然后一行命令搞定

npm install

其他package安装命令

运行如下命令,列出所有npm install
可能的参数形式

npm install --help

输出如下,有兴趣的童鞋可以了解下

npm install <tarball file>

npm install <tarball url>

npm install <folder>

npm install <pkg>

npm install <pkg>@<tag>

npm install <pkg>@<version>

npm install <pkg>@<version range>

卸载grunt-cli
比如卸载grunt-cli

npm uninstall grunt-cli

卸载0.1.9版本的grunt-cli

npm uninstall [grunt-cli@"0.1.9](mailto:grunt-cli@%220.1.9)"

npm ls:查看安装了哪些包
运行如下命令,就可以查看当前目录安装了哪些package

npm ls

输出如下

/private/tmp/npm

└─┬ [grunt-cli@0.1.9](mailto:grunt-cli@0.1.9)

  ├─┬ [findup-sync@0.1.2](mailto:findup-sync@0.1.2)

  │ ├─┬ [glob@3.1.21](mailto:glob@3.1.21)

  │ │ ├── [graceful-fs@1.2.3](mailto:graceful-fs@1.2.3)

  │ │ ├── [inherits@1.0.0](mailto:inherits@1.0.0)

  │ │ └─┬ [minimatch@0.2.12](mailto:minimatch@0.2.12)

  │ │   ├── [lru-cache@2.3.0](mailto:lru-cache@2.3.0)

  │ │   └── [sigmund@1.0.0](mailto:sigmund@1.0.0)

  │ └── [lodash@1.0.1](mailto:lodash@1.0.1)

  ├─┬ [nopt@1.0.10](mailto:nopt@1.0.10)

  │ └── [abbrev@1.0.4](mailto:abbrev@1.0.4)

  └── [resolve@0.3.1](mailto:resolve@0.3.1)

输出如下,同样,如果是要查看package的全局安装信息,加上-g
就可以
npm ls pkg:查看特定package的信息
运行如下命令,输出grunt-cli的信息

npm ls grunt-cli

输出的信息比较有限,只有安装目录、版本,如下:

/private/tmp/npm

└── [grunt-cli@0.1.9](mailto:grunt-cli@0.1.9) 

如果要查看更详细信息,可以通过npm info pkg
,输出的信息非常详尽,包括作者、版本、依赖等。
npm info grunt-cli

npm update pkg:package更新
npm update grunt-cli

npm search pgk:搜索

输入如下命令

npm search grunt-cli

返回结果如下

npm http GET [http://registry.npmjs.org/-/all/since?stale=update_after&startkey=1375519407838](http://registry.npmjs.org/-/all/since?stale=update_after&startkey=1375519407838)

npm http 200 [http://registry.npmjs.org/-/all/since?stale=update_after&startkey=1375519407838](http://registry.npmjs.org/-/all/since?stale=update_after&startkey=1375519407838)

NAME                  DESCRIPTION                                        AUTHOR            DATE              KEYWORDS

grunt-cli             The grunt command line interface.                  =cowboy =tkellen  2013-07-27 02:24

grunt-cli-dev-exitprocess The grunt command line interface.              =dnevnik          2013-03-11 16:19

grunt-client-compiler Grunt wrapper for client-compiler.                 =rubenv           2013-03-26 09:15  gruntplugin

grunt-clientside      Generate clientside js code from CommonJS modules  =jga              2012-11-07 01:20  gruntplugin

NPM发布

这个命令我自己也还没实际用过,不误导大家,语法如下,也可参考官方对于package发布的说明https://npmjs.org/doc/developers.html

npm publish <tarball>

npm publish <folder>

NPM配置

npm的配置工作主要是通过npm config
命令,主要包含增、删、改、查几个步骤,下面就以最为常用的proxy配置为例。

设置proxy
内网使用npm很头痛的一个问题就是代理,假设我们的代理是 http://proxy.example.com:8080,那么命令如下:

npm config set proxy http://proxy.example.com:8080

由于npm config set
命令比较常用,于是可以如下简写

npm set proxy http://proxy.example.com:8080 

查看proxy
设置完,我们查看下当前代理设置

npm config get proxy

输出如下:

http://proxy.example.com:8080/

同样可如下简写:

npm get proxy

删除proxy
代理不需要用到了,那删了吧

npm delete proxy

查看所有配置

npm config list

直接修改配置文件
有时候觉得一条配置一条配置地修改有些麻烦,就直接进配置文件修改了

npm config edit

关于package.json

这货在官网似乎没有详细的描述,其实就是包的描述信息啦。假设当我们下载了node应用,这个node应用依赖于A、B、C三个包,如果没有package.json,我们需要人肉安装这个三个包(如果对版本有特定要求就更悲剧了):

npm install A

npm install B

npm install C

有了package.json,一行命令安装所有依赖。

npm install

package.json字段简介
字段相当多,但最重要的的是下面几个
name: package的名字(由于他会成为url的一部分,所以 non-url-safe 的字母不会通过,也不允许出现"."、"_"),最好先在http://registry.npmjs.org/上搜下你取的名字是否已经存在

version: package的版本,当package发生变化时,version也应该跟着一起变化,同时,你声明的版本需要通过semver的校验(semver可自行谷歌)
dependencies: package的应用依赖模块,即别人要使用这个package,至少需要安装哪些东东。应用依赖模块会安装到当前模块的node_modules目录下。
devDependenciespackage的开发依赖模块,即别人要在这个package上进行开发
其他:参见官网

package版本

package.json里,你经常会在包名后看到类似"~0.1.0"这样的字符串,这就是包的版本啦。下面会列举最常见的版本声明形式,以及版本书写的要求:
常见版本声明形式
a、"~1.2.3"是神马意思呢,看下面领悟

"~1.2.3" = ">=1.2.3 <1.3.0"

"~1.2" = ">=1.2.0 <1.3.0"

"~1" = ">=1.0.0 <1.1.0"

b、"1.x.x"是什么意思呢,继续自行领悟

"1.2.x" = ">=1.2.0 <1.3.0"

"1.x.x" = ">=1.0.0 <2.0.0"

"1.2" = "1.2.x"

"1.x" = "1.x.x"

"1" = "1.x.x"

版本书写要求
版本可以v开头,比如 v1.0.1v只是可选)
1.0.1-7,这里的7是所谓的“构建版本号”,不理是神马,反正版本大于1.0.1
1.0.1beta,或者1.0.1-beta,如果1.0.1后面不是 “连字符加数字” 这种形式,那么它是pre release 版本,即版本小于1.0.1
根据b、c,有:0.1.2-7 > 0.1.2-7-beta > 0.1.2-6 > 0.1.2 > 0.1.2beta

写在后面

内容只是简单地把最常见的命令,以及一些需要了解的内容列了出来。如要进一步了解,可参考官网说明。此外:

npm help

是我们最好的朋友,如果忘了有哪些命令,命令下有哪些参数,可通过help进行查看。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容

  • 1、什么是NPM? NPM(node package manager),通常称为node包管理器,主要功能就是管理...
    皆为序幕__so阅读 8,868评论 0 2
  • Nodejs的出现,可以算是前端里程碑式的一个事件,它让前端攻城狮们摆脱了浏览器的束缚,踏上了一个更加宽广的舞台。...
    彬_仔阅读 2,709评论 0 3
  • 快速入门 Grunt和 Grunt 插件是通过 npm 安装并管理的,npm是 Node.js 的包管理器。Gru...
  • Node.js使得在服务器端使用JavaScript编写应用程序成为可能。它是基于V8Javascript运行时并...
    间阳幕宾阅读 1,577评论 0 5
  • 秋日 秋思不绝 秋日 瞌睡连连 秋日与众人互道 中秋快乐 秋日远游 与水翁言老 与沙粒,茫茫无尽的海水 互道早安 ...
    公子九月回阅读 203评论 0 1