# # npm

## # 全局安装包

    ├── @vue/cli@3.0.5
    ├── @vue/eslint-config-airbnb@3.0.5
    ├── create-react-app@2.0.4
    ├── create-react-native-app@2.0.2
    ├── egg-init@1.15.0
    ├── eslint@5.8.0
    ├── express-generator@4.16.0
    ├── gatsby-cli@2.4.3
    ├── gitbook-cli@2.3.2
    ├── hexo-cli@1.1.0
    ├── http-server@0.11.1
    ├── less@3.8.1
    ├── n@2.1.12
    ├── nodemon@1.18.5
    ├── npm@6.4.1
    ├── typescript@3.1.3
    └── vuepress@0.14.4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

参考文章:
https://wohugb.gitbooks.io/npm/content/index.html
https://blog.csdn.net/SayDream/article/details/52106936

## # npm是什么

NPM的全称是Node Package Manager，是随同NodeJS一起安装的包管理和分发工具，它很方便让JavaScript开发者下载、安装、上传以及管理已经安装的包。

## # npm install 安装模块

基础语法

    npm install (with no args, in package dir)
    npm install [<@scope>/]<name>
    npm install [<@scope>/]<name>@<tag>
    npm install [<@scope>/]<name>@<version>
    npm install [<@scope>/]<name>@<version range>
    npm install <tarball file>
    npm install <tarball url>
    npm install <folder>
    alias: npm i
    common options: [-S|--save|-D|--save-dev|-O|--save-optional] [-E|--save-exact] [--dry-run]

1
2
3
4
5
6
7
8
9
10

安装包，默认会安装最新的版本

    npm install gulp

1

安装指定版本

    npm install gulp@3.9.1

1

## # 安装包并将信息保持到项目的package.json文件中

项目对模块的依赖可以使用下面的 3 种方法来表示（假设当前版本号是 1.1.0 ）：
兼容模块新发布的补丁版本：~1.1.0、1.1.x、1.1兼容模块新发布的小版本、补丁版本：^1.1.0、1.x、1兼容模块新发布的大版本、小版本、补丁版本：* 、x

### # -S, --save 安装包信息将加入到dependencies（生产阶段的依赖）

    npm install gulp --save 或 npm install gulp -S

1

### # package.json 文件的 dependencies 字段：

    npm install gulp --save-dev 或 npm install gulp -D

1

### # package.json 文件的 devDependencies字段：

    "devDependencies": { "gulp": "^3.9.1"}

1

### # -O, --save-optional 安装包信息将加入到optionalDependencies（可选阶段的依赖）

    npm install gulp --save-optional 或 npm install gulp -O

1

### # package.json 文件的optionalDependencies字段：

    "optionalDependencies": { "gulp": "^3.9.1"},

1

### # -E, --save-exact 精确安装指定模块版本

    npm install gulp --save-exact 或 npm install gulp -E

1

### # 输入命令npm install gulp -ES，留意package.json 文件的 dependencies 字段，以看出版本号中的^消失了

    "dependencies": { "gulp": "3.9.1"}

1

### # 模块的依赖都被写入了package.json文件后，他人打开项目的根目录（项目开源、内部团队合作），使用npm install命令可以根据dependencies配置安装所有的依赖包

    npm install

1

## # 本地安装（local）

    npm install gulp

1

## # 全局安装（global）,使用-g 或 --global

    npm install gulp -g

1

## # npm ls查看安装的模块

基础语法

    npm ls [[<@scope>/]<pkg> ...]aliases: list, la, ll

1

## # 查看全局安装的模块及依赖

    npm ls -g

1

## # npm uninstall卸载模块

基础语法

    npm uninstall\
     [<@scope>/]<pkg>[@<version>]... [-S|--save|-D|--save-dev|-O|\
     --save-optional]aliases: remove, rm, r, un, unlink

1
2
3

### # 如卸载开发版本的模块

从 `node_modules` 目录删除包命令 `npm uninstall [<package>]`:

    npm uninstall lodash

1

去除`package.json`依赖关系, 需要 `save`|`dev` 标签:

    npm uninstall lodash --save-dev

1

卸载全局包命令 `npm uninstall -g [<package>]`:

    npm uninstall -g jshint

1

## # npm update更新模块

基础语法

    npm update [-g] [<pkg>...]

1

实例:更新当前项目下所有的依赖包

    # --dev 同时更新devDependencies内容
    # --save 把更新情况保存到package.json
    # -d 查看细节
    npm  update --dev --save -d

1
2
3
4

### # 更新全局包

更新全局包命令 `npm install -g [<package>]`:

    npm install -g jshint

1

查找过期包

    npm outdated -g --depth=0

1

更新所有全局包

    npm update -g

1

## # npm outdated检查模块是否已经过时

基础语法:此命令会列出所有已经过时的包，可以及时进行包的更新

    npm outdated [[<@scope>/]<pkg> ...]

1

## # npm init在项目中引导创建一个package.json文件

安装包的信息可保持到项目的package.json文件中，以便后续的其它的项目开发或者他人合作使用，也说package.json在项目中是必不可少的。

    npm init [-f|--force|-y|--yes]

1

## # npm help 查看某条命令的详细帮助

例如输入`npm help install`，系统在默认的浏览器或者默认的编辑器中打开本地`nodejs`安装包的文件`/nodejs/node_modules/npm/html/doc/cli/npm-install.html`

    npm help <command>

1

## # npmroot查看包的安装路径

输出node_modules的路径

    npm root [-g]

1

## # npm config管理npm的配置路径

基础语法

    npm config set <key> <value> [-g|--global]\
    npm config get <key>npm config delete <key>\
    npm config listnpm config editnpm get <key>\
    npm set <key> <value> [-g|--global]

1
2
3
4

对于config这块用得最多应该是设置代理，解决npm安装一些模块失败的问题

例如我在公司内网，因为公司的防火墙原因，无法完成任何模块的安装，这个时候设置代理可以解决

    npm config set proxy=http://dev-proxy.oa.com:8080

1

又如国内的网络环境问题，某官方的IP可能被和谐了，幸好国内有好心人，搭建了镜像，此时我们简单设置镜像

    npm config set registry="http://r.cnpmjs.org"

1

## # npm cache 管理模块的缓存

基础语法

    npm cache add [<tarball file>]\
    npm cache add [<folder>]npm cache add [<tarball url>]\
    npm cache add [<name>]@[<version>]\
    npm cache ls [<path>]\
    npm cache clean [<path>]

1
2
3
4
5

最常用命令无非清除npm本地缓存

    npm cache clean

1

## # npm start 启动模块

基础语法

    npm start [-- <args>]

1

该命令写在package.json文件scripts的start字段中，可以自定义命令来配置一个服务器环境和安装一系列的必要程序，如

    "scripts": { "start": "gulp -all"}

1

如果package.json文件没有设置start，则将直接启动node server.js

npm stop 停止模块

基础语法

    npm stop [-- <args>]

1

## # npm restart 重新启动模块

基础语法

    npm restart [-- <args>]

1