npm简介

目录

• NPM 使用介绍
  • 查看版本
  • 命令安装
• 镜像切换
  • 获取配置文件的镜像地址
  • 使用某个镜像下载模块
    • 修改npm的配置文件（第一种方法）
    • 修改配置文件镜像（第二种方法）
• 全局安装与本地安装
  • 本地安装
  • 全局安装
• 常用命令
  • 创建模块
  • 卸载模块
  • 更新模块
  • 查看依赖列表
  • 搜索模块
    • 查看全局安装模块
  • 查看当前项目某个模块的版本号
  • 删除代理
  • 查看所有命令&查找帮助
  • 查看某条命令的详细帮助
• package.json 介绍
  • 属性说明
  • 安装软件包并将其另存为package.json文件中的依赖项
    • 在 npm 资源库中注册用户（使用邮箱注册）
    • 发布模块
  • 撤销发布自己发布过的某个版本代码
  • 清空NPM本地缓存，对付使用相同版本号发布新版本代码的人
• 版本号
  • 样例（node_modules/express/package.json内容）

NPM 使用介绍

• NPM是随同NodeJS一起安装的包管理工具，就像maven工具。
• 新版的nodejs已经集成了npm，所以之前npm也一并安装好了。
• 同样可以通过输入 "npm -v" 来测试是否成功安装。

查看版本

npm -v

命令安装

npm install <Module Name>

镜像切换

获取配置文件的镜像地址

npm get registry 

使用某个镜像下载模块

npm install -g cnpm --registry=https://registry.npm.taobao.org

修改npm的配置文件（第一种方法）

npm config edit

registry=https://registry.npm.taobao.org

修改配置文件镜像（第二种方法）

//原始
npm config set registry https://registry.npmjs.org
//淘宝
npm config set registry http://registry.npm.taobao.org/
//淘宝
npm config set registry http://npm.taobao.org

全局安装与本地安装

npm 的包安装分为本地安装（local）、全局安装（global）两种

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

如果出现以下错误：

npm err! Error: connect ECONNREFUSED 127.0.0.1:8087 

解决办法为：

npm config set proxy null

本地安装

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

全局安装

• 1. 将安装包放在 /usr/local 下或者你 nodejs 的安装目录（C: odejs ode_modules）。
• 2. 可以直接在命令行里使用。

常用命令

创建模块

npm init

卸载模块

npm uninstall express

卸载后，你可以到 /node_modules/ 目录下查看包是否还存在，或者查看依赖列表是否还存在该依赖。

更新模块

npm update express

查看依赖列表

npm ls

搜索模块

npm search express

查看全局安装模块

npm list -g

查看当前项目某个模块的版本号

npm list grunt

删除代理

npm config rm proxy 
npm config rm https-proxy

查看所有命令&查找帮助

npm help

查看某条命令的详细帮助

npm help install

package.json 介绍

package.json 位于模块的目录下，用于定义包的属性。

属性说明

• name - 包名。
• version - 包的版本号。
• description - 包的描述。
• homepage - 包的官网 url 。
• author - 包的作者姓名。
• contributors - 包的其他贡献者姓名。
• dependencies - 依赖包列表。如果依赖包没有安装，npm 会自动将依赖包安装在 node_module 目录下。
• repository - 包代码存放的地方的类型，可以是 git 或 svn，git 可在 Github 上。
• main - main 字段指定了程序的主入口文件，require('moduleName') 就会加载这个文件。这个字段的默认值是模块根目录下面的 index.js。
• keywords - 关键字

安装软件包并将其另存为package.json文件中的依赖项

npm install <pkg> --save

在 npm 资源库中注册用户（使用邮箱注册）

npm adduser

发布模块

npm publish

撤销发布自己发布过的某个版本代码

npm unpublish <package>@<version>

清空NPM本地缓存，对付使用相同版本号发布新版本代码的人

npm cache clear

版本号

使用NPM下载和发布代码时都会接触到版本号。NPM使用语义版本号来管理代码，这里简单介绍一下。

语义版本号分为X.Y.Z三位，分别代表主版本号、次版本号和补丁版本号。当代码变更时，版本号按以下原则更新。

• 如果只是修复bug，需要更新Z位。
• 如果是新增了功能，但是向下兼容，需要更新Y位。
• 如果有大变动，向下不兼容，需要更新X位。

版本号有了这个保证后，在申明第三方包依赖时，除了可依赖于一个固定版本号外，还可依赖于某个范围的版本号。例如"argv": "0.0.x"表示依赖于0.0.x系列的最新版argv。

样例（node_modules/express/package.json内容）

{
  "name": "express",
  "description": "Fast, unopinionated, minimalist web framework",
  "version": "4.13.3",
  "author": {
    "name": "TJ Holowaychuk",
    "email": "tj@vision-media.ca"
  },
  "contributors": [
    {
      "name": "Aaron Heckmann",
      "email": "aaron.heckmann+github@gmail.com"
    },
    {
      "name": "Ciaran Jessup",
      "email": "ciaranj@gmail.com"
    },
    {
      "name": "Douglas Christopher Wilson",
      "email": "doug@somethingdoug.com"
    },
    {
      "name": "Guillermo Rauch",
      "email": "rauchg@gmail.com"
    },
    {
      "name": "Jonathan Ong",
      "email": "me@jongleberry.com"
    },
    {
      "name": "Roman Shtylman",
      "email": "shtylman+expressjs@gmail.com"
    },
    {
      "name": "Young Jae Sim",
      "email": "hanul@hanul.me"
    }
  ],
  "license": "MIT",
  "repository": {
    "type": "git",
    "url": "git+https://github.com/strongloop/express.git"
  },
  "homepage": "http://expressjs.com/",
  "keywords": [
    "express",
    "framework",
    "sinatra",
    "web",
    "rest",
    "restful",
    "router",
    "app",
    "api"
  ],
  "dependencies": {
    "accepts": "~1.2.12",
    "array-flatten": "1.1.1",
    "content-disposition": "0.5.0",
    "content-type": "~1.0.1",
    "cookie": "0.1.3",
    "cookie-signature": "1.0.6",
    "debug": "~2.2.0",
    "depd": "~1.0.1",
    "escape-html": "1.0.2",
    "etag": "~1.7.0",
    "finalhandler": "0.4.0",
    "fresh": "0.3.0",
    "merge-descriptors": "1.0.0",
    "methods": "~1.1.1",
    "on-finished": "~2.3.0",
    "parseurl": "~1.3.0",
    "path-to-regexp": "0.1.7",
    "proxy-addr": "~1.0.8",
    "qs": "4.0.0",
    "range-parser": "~1.0.2",
    "send": "0.13.0",
    "serve-static": "~1.10.0",
    "type-is": "~1.6.6",
    "utils-merge": "1.0.0",
    "vary": "~1.0.1"
  },
  "devDependencies": {
    "after": "0.8.1",
    "ejs": "2.3.3",
    "istanbul": "0.3.17",
    "marked": "0.3.5",
    "mocha": "2.2.5",
    "should": "7.0.2",
    "supertest": "1.0.1",
    "body-parser": "~1.13.3",
    "connect-redis": "~2.4.1",
    "cookie-parser": "~1.3.5",
    "cookie-session": "~1.2.0",
    "express-session": "~1.11.3",
    "jade": "~1.11.0",
    "method-override": "~2.3.5",
    "morgan": "~1.6.1",
    "multiparty": "~4.1.2",
    "vhost": "~3.0.1"
  },
  "engines": {
    "node": ">= 0.10.0"
  },
  "files": [
    "LICENSE",
    "History.md",
    "Readme.md",
    "index.js",
    "lib/"
  ],
  "scripts": {
    "test": "mocha --require test/support/env --reporter spec --bail --check-leaks test/ test/acceptance/",
    "test-ci": "istanbul cover node_modules/mocha/bin/_mocha --report lcovonly -- --require test/support/env --reporter spec --check-leaks test/ test/acceptance/",
    "test-cov": "istanbul cover node_modules/mocha/bin/_mocha -- --require test/support/env --reporter dot --check-leaks test/ test/acceptance/",
    "test-tap": "mocha --require test/support/env --reporter tap --check-leaks test/ test/acceptance/"
  },
  "gitHead": "ef7ad681b245fba023843ce94f6bcb8e275bbb8e",
  "bugs": {
    "url": "https://github.com/strongloop/express/issues"
  },
  "_id": "express@4.13.3",
  "_shasum": "ddb2f1fb4502bf33598d2b032b037960ca6c80a3",
  "_from": "express@*",
  "_npmVersion": "1.4.28",
  "_npmUser": {
    "name": "dougwilson",
    "email": "doug@somethingdoug.com"
  },
  "maintainers": [
    {
      "name": "tjholowaychuk",
      "email": "tj@vision-media.ca"
    },
    {
      "name": "jongleberry",
      "email": "jonathanrichardong@gmail.com"
    },
    {
      "name": "dougwilson",
      "email": "doug@somethingdoug.com"
    },
    {
      "name": "rfeng",
      "email": "enjoyjava@gmail.com"
    },
    {
      "name": "aredridel",
      "email": "aredridel@dinhe.net"
    },
    {
      "name": "strongloop",
      "email": "callback@strongloop.com"
    },
    {
      "name": "defunctzombie",
      "email": "shtylman@gmail.com"
    }
  ],
  "dist": {
    "shasum": "ddb2f1fb4502bf33598d2b032b037960ca6c80a3",
    "tarball": "http://registry.npmjs.org/express/-/express-4.13.3.tgz"
  },
  "directories": {},
  "_resolved": "https://registry.npmjs.org/express/-/express-4.13.3.tgz",
  "readme": "ERROR: No README data found!"
}