npm命令
##################

* 官网: http://npmjs.org/
* GitHub: https://github.com/isaacs/npm.git

* npm（Node Package Manager）是 Node.js 自带的包管理工具，用于安装、管理和发布 JavaScript 库和应用程序。它是目前全球最大的 JavaScript 软件包生态系统之一。

.. note:: npm 适用于所有 Node.js 项目，但如果追求更快的速度，可以考虑 yarn 或 pnpm。


npm 的安装
==========

* npm 默认随 Node.js 一起安装，安装 Node.js 后可直接使用 npm。
* 更新 npm::

    npm install -g npm

配置文件
========

* 使用 package.json 和 package-lock.json 维护依赖，确保项目可复现。



常见命令
========

包管理
------


基本::

    npm -v #显示版本，检查npm 是否正确安装。
    # 初始化项目，会创建 package.json
    npm init

安装npm包::

    # 安装某个 npm 包（默认安装最新版本）
    npm install <package>
    # 安装指定版本的 npm 包，如 npm install express@4.17.1
    npm install <package>@<version>
    # 全局安装某个 npm 包（适用于 CLI 工具）
    npm install -g <package>

    # 添加--save-dev选项，把express模块安装依赖里
    npm install <package> --save
    // save-dev选项，把模块安装在开发依赖里
    npm install <package> --save-dev

查看相关包::

    npm list    查看已安装的包
    npm list -g 查看全局安装的包

    npm show <package> #显示模块详情

    npm outdated    查看哪些依赖包需要更新


其他::

    npm uninstall <package> 卸载某个 npm 包


    npm update #升级当前目录下的项目的所有模块
    npm update express #升级当前目录下的项目的指定模块
    npm update -g express #升级全局安装的express模块


    npm prune   删除 package.json 中未列出的包


运行脚本
--------

* npm run xxx 命令基本是执行「package.json」文件中的scripts字段下面的命令

package.json::

    {
      "scripts": {
        "start": "node app.js",
        "dev": "nodemon app.js"
      }
    }

执行::

    npm run start
    npm run dev


清理缓存
--------

::

    npm cache clean --force




配置相关
--------

::

  npm config list

  // 设定配置
  npm config set registry=http://registry.npmjs.org
  npm -g --registry http://registry.cnpmjs.org  install appium
  
  // taobao版
  npm config set registry https://registry.npm.taobao.org --global
  npm config set disturl https://npm.taobao.org/dist —global



  step 1. 下载源代码，比如 https://github.com/appium/appium/archive/v0.17.6.tar.gz， 0.17.6 的源代码。
  step 2. 解压到目录，比如 appium-0.17.6
  step 3. sudo npm config set registry=http://registry.npmjs.org 或者 npm config set registry=http://registry.npmjs.org
  step 4. npm install -g appium-0.17.6




国内镜像
========

介绍::

    1.通过config命令
    npm config set registry https://registry.npm.taobao.org
    npm info underscore （如果上面配置正确这个命令会有字符串response）

    2.命令行指定
    npm --registry https://registry.npm.taobao.org info underscore

    3.编辑 ~/.npmrc 加入下面内容
    registry = https://registry.npm.taobao.org

    搜索镜像: https://npm.taobao.org
    建立或使用镜像,参考: https://github.com/cnpm/cnpmjs.org