npm使用详解

npmNode.js 官方提供的包管理工具,它已经成了 Node.js 包的标准发布平台,用于 Node.js 包的发布、传播、依赖控制。npm 提供了命令行工具,使你可以方便地下载、安装、升级、删除包,也可以让你作为开发者发布并维护包。

npm 是随同 Node.js 一起安装的包管理工具,能解决 Node.js 代码部署上的很多问题,常见的场景有以下几种:

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

安装

  1. 新版的nodejs已经集成了npm,测试版本:
$npm -v
6.9.0
  1. 升级
$sudo npm install npm -g
  1. windows 环境
npm install npm -g
  1. 查看npm拥有的全部命令
$ npm --help
$ npm help
查看某一个npm命令的详细用法
$ npm <command> --help
$ npm help <command>

使用

  1. 包管理
npm install <package_name>

例如安装express

$npm install express          # 本地安装
$npm install express -g   # 全局安装

指定一个版本:

$npm install express@4.0.1
  • 查看模块的当前版本号
 npm view 模块名 version

需要注意的是查看到的模块版本是该模块再远程仓库的版本号,并不是当前项目中所依赖的版本号。

  • 查看当前项目中应用的某个模块的版本号的命令为
 npm list 模块名 version
  • 查看模块的历史版本和当前版本
 npm view 模块名 versions
  • 查看一个模块的所有信息
 npm view 模块名

本地安装的话,包会安装当前目录node_modules文件夹下
在全局模式下面,NPM会把包安装到/usr/local/lib/node_module

常见错误:

npm err! Error: connect ECONNREFUSED 127.0.0.1:8087
运行 npm config set proxy null
  1. 查看全局安装
$npm list -g --depth 0
  1. 设置环境变量
    下面命令等于为 npm init 设置了默认值,以后执行 npm init 的时候,package.json 的作者姓名、邮件、主页、许可证字段就会自动写入预设的值。这些信息会存放在用户主目录的 ~/.npmrc文件,使得用户不用每个项目都输入。如果某个项目有不同的设置,可以针对该项目运行npm config
$ npm set init-author-name 'Your name'
$ npm set init-author-email 'Your email'
$ npm set init-author-url 'http://yourdomain.com'
$ npm set init-license 'MIT'
  1. npm常用命令
  • npm init 会引导你创建一个package.json文件,包括名称、版本、作者这些信息等
  • npm install <name> 安装nodejs的依赖包
  • npm install <name> -g 将包安装到全局环境中
  • npm install <name> --save 安装的同时,将信息写入package.json中。项目路径中如果有package.json文件时,直接使用npm install方法就可以根据dependencies配置安装所有的依赖包
  • npm remove <name> 移除
  • npm update <name> 更新
  • npm ls 列出当前安装的了所有包
  • npm root 查看当前包的安装路径
  • npm root -g 查看全局的包的安装路径
  • npm info 命令可以查看每个模块的具体信息。
  • npm prune 清除未被使用到的模块

5.使用 package.json

通常我们使用npm init命令来创建一个npm程序时,会自动生成一个package.json文件。package.json文件会描述这个NPM包的所有相关信息,包括作者、简介、包依赖、构建等信息,格式是严格的JSON格式。

  • 命令行方式创建package.json
$ npm init //生成一个package.json

然后在当前目录生成一个基本的package.json文件。所有问题之中,只有项目名称(name)和项目版本(version)是必填的,其他都是选填的,一路下一步。

  • 查看生成的package
$cat package.json
{
  "name": "test",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC"
  • 属性介绍

    • name
      name和version是package.json中最重要的两个字段,也是发布到NPM平台上的唯一标识,如果没有正确设置这两个字段,包就不能发布和被下载。

    • version
      包的版本号。如"1.0.0"。
      在node.js中的package.json配置文件中,我们需要配置版本号,比如0.1.2
      第一位数字:主版本号
      第二位数字:子版本号
      第三位数字:补丁版本号

    • description
      包的描述信息,将会在npm search的返回结果中显示,以帮助用户选择合适的包。

    • keywords
      包的关键词信息,是一个字符串数组,同上也将显示在npm search的结果中。

    • homepage
      包的主页地址。

    • bugs
      包的bug跟踪主页地址。

    • license
      包的开源协议名称。

    • author
      包的作者。

    • contributors, maintainers
      包的贡献者,是一个数组。

    • files(较少用)
      包所包含的所有文件,可以取值为文件夹。通常我们还是用.npmignore来去除不想包含到包里的文件。

    • main
      包的入口文件。

    • bin(较少用)
      如果你的包里包含可执行文件,通过设置这个字段可以将它们包含到系统的PATH中,这样直接就可以运行,很方便。

  • man(较少用)
    为系统的man命令提供帮助文档。帮助文件的文件名必须以数字结尾,如果是压缩的,需要以.gz结尾。
    "man": ["./man/foo.1", "./man/bar.1", "./man/foo.2" ]
    directories(较少用)
    CommonJS包所要求的目录结构信息,展示项目的目录结构信息。字段可以是:lib, bin, man, doc, example。值都是字符串。

    • repository
      包的仓库地址。
      "repository": {
      "type": "git",
      "url": "git+https://github.com/rainnaZR/es6-react.git"
      },

    • scripts
      通过设置这个可以使NPM调用一些命令脚本,封装一些功能。
      "scripts": {"start": "babel-node src/pages/index.js",
      "build": "webpack --config config/webpack.config.js",
      "watch": "webpack-dev-server --config config/webpack.config.js --hot --inline --progress"
      }

    • config
      添加一些设置,可以供scripts读取用,同时这里的值也会被添加到系统的环境变量中。
      "config": {
      "port": "8080"
      }
      npm start的时候会读取到npm_package_config_port环境变量。

    • dependencies
      指定依赖的其它包,这些依赖是指包发布后正常执行时所需要的,也就是线上需要的包。使用下面的命令来安装:
      npm install --save packageName
      如果是开发中依赖的包,可以在devDependencies设置。

    • devDependencies
      这些依赖只有在开发时候才需要。使用下面的命令来安装:
      npm install --save-dev packageName

    • peerDependencies
      相关的依赖,如果你的包是插件,而用户在使用你的包时候,通常也会需要这些依赖(插件),那么可以将依赖列到这里。

    • bundledDependencies
      绑定的依赖包,发布的时候这些绑定包也会被一同发布。

    • optionalDependencies(较少用)
      即使这些依赖没有,也可以正常安装使用。

    • engines(较少用)
      指定包运行的环境。
      "engines": {
      "node": ">=0.10.3 < 0.12",
      "npm": "~1.0.20"
      }

    • os(较少用)
      指定你的包可以在哪些系统平台下运行。
      "os": [ "darwin", "linux", "!win32" ]
      cpu(较少用)
      可以指定包运行的cpu架构。

    • private
      设为true这个包将不会发布到NPM平台下。

    • publishConfig(较少用)
      这个字段用于设置发布时候的一些设定。尤其方便你希望发布前设定指定的tag或registry。
      当你有了一个完整的 package.json 文件的时候,就可以让人一眼看出来,这个模块的基本信息,和这个模块所需要依赖的包。我们可以通过 npm install就可以很方便的下载好这个模块所需要的包。
      npm install 默认会安装 dependencies 字段和 devDependencies 字段中的所有模块,如果使用 --production 参数,可以只安装 dependencies 字段的模块:

$npm install
和
$npm install --production 

一旦安装了某个模块,就可以在代码中用 require 命令加载这个模块,例如:

let backbone = require('backbone')

package.json 的版本控制

例如:

"cluster": ">= 0.7.7",
"commander": "^2.6.0",
"async" : "*",
第一种:
貌似通过字面意思你应该懂得, cluster 版本必须大于等于 0.7.7
npm 安装的时候你也可以这样指定:
npm install cluster@">=0.7.7"
甚至你可以把版本范围指定到更小
npm install cluster@">=0.7.7<0.8.0"
让安装的版本大于0.7.7并且小于 0.8.0

第二种:
^ 符号表示,可以接受小版本和补丁版本的变化.简单说就是大版本不变即可,其他版本随便更新.
"commander":"^2.6.0"  
当我们npm install 的时候,安装到 node_modules 目录下的 
commander开源包可能是 2.6.0 或 2.7.3 或 2.8.9

第三种:
"async": " * "
最糟糕的一种版本控制,一点限制没有.

第四种:
当主版本号/次版本号/修订版本号为X or x or *时,
那么update或install是会下载该分支最新的版本号

第五种:
波浪号(~)是限定模块的次要版本
~1.5.1允许安装版本号大于1.5.1但小于1.6.0版本的模块

scripts 脚本

npm 不仅可以用于模块管理,还可以用于执行脚本。package.json 文件有一个 scripts 字段,可以用于指定脚本命令,供 npm 直接调用。

顾名思义,scripts就是一些脚本代码,可以通过
npm run script-key 来调用,例如在这个 package.json 的文件夹下使用npm run dev就相当于运行了node build/dev-server.js这一段代码。使用 scripts 的目的就是为了把一些要执行的代码合并到一起,使用 npm run 来快速的运行,方便省事。
npm run 是 npm run-script 的缩写,一般都使用前者,但是后者可以更好的反应这个命令的本质。

更换源

  1. 全局安装nrm
$ npm install -g nrm
  1. 列出可选的源:
    带*号的表示当前在使用的源
$nrm ls
* npm ---- https://registry.npmjs.org/
  cnpm --- http://r.cnpmjs.org/
  taobao - https://registry.npm.taobao.org/
  nj ----- https://registry.nodejitsu.com/
  npmMirror  https://skimdb.npmjs.com/registry/
  edunpm - http://registry.enpmjs.org/
  1. 切换成淘宝源:
 $ nrm use taobao
  Registry has been set to: https://registry.npm.taobao.org/
  1. 测试所有源的响应时间:
$nrm test    
 npm ---- 314ms
  cnpm --- 350ms
* taobao - 300ms
  nj ----- Fetch Error
  npmMirror  1153ms
  edunpm - Fetch Error
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,907评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,987评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,298评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,586评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,633评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,488评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,275评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,176评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,619评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,819评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,932评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,655评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,265评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,871评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,994评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,095评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,884评论 2 354