npm 常用命令及配置总结

发表于 更新于

工作中由于前端项目打包、各类工具使用（如本博客就是基于 Node.js）经常要用到 npm，下面总结一下。

npm 是随 Node.js 自动安装的，由三个独立的部分组成：

  • 网址：开发者查找包（package）、设置参数以及管理 npm 使用体验的主要途径。
  • 注册表（Registry）：一个巨大的数据库，保存了每个包（package）的信息。
  • 命令行工具（CLI）：命令行或终端运行。开发者通过 CLI 与 npm 打交道。

安装

OS X 推荐使用 HomeBrew 安装：

1
brew install node --with-npm

其它：

https://nodejs.org/zh-cn/download/

npm 命令

NPM CLI Commands

npm install -g <package> 全局安装：

  • Windows：

    • 安装目录 C:\Users\Admin\AppData\Roaming\npm\node_modules\<package>
    • 生成可执行脚本：C:\Users\Admin\AppData\Roaming\npm\<package>
    • 由于目录 C:\Users\Admin\AppData\Roaming\npm 已加入 PATH 环境变量，因为可以直接执行对应命令。

  • OS X：

    • 安装目录 /usr/local/lib/node_modules/<package>
    • 生成软链，例如：/usr/local/bin/npm -> /usr/local/lib/node_modules/npm/bin/npm-cli.js

npm list -g -depth=0 验证是否安装到位。

npm 配置

npm 配置主要有两份：

  • npmrc：npm 从命令行、环境变量、npmrc 文件中读取配置。
  • package.json：包（package）配置文件。

重点了解下 package.json，重点属性有 name、version、dependencies、main：

属性 描述
name 包名
version 包的语义版本号：X.Y.Z：如果有大变动，向下不兼容，需要更新主版本号X；如果是新增了功能，但是向下兼容，需要更新次版本号 Y；如果只是修复bug，需要更新补丁版本号 Z
description 包的描述
homepage 包的官网 url
author 包的作者姓名
contributors 包的其他贡献者姓名
dependencies 依赖包列表。如果依赖包没有安装，npm 会自动将依赖包安装在 node_module 目录下
repository 包代码存放的地方的类型，可以是 git 或 svn，git 可在 Github 上
main main 字段是一个模块ID，它是一个指向你程序的主要项目。就是说，如果你包的名字叫 express，然后用户安装它，然后require("express")
keywords 关键字

淘宝 npm 镜像

为了解决慢的问题，推荐使用淘宝 npm 镜像。三种使用方式：

  • 使用淘宝定制的 cnpm 命令行工具代替默认的 npm，安装方法：

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

  • 永久配置 npm 命令行工具：

    1
    2
    3
    $ npm config set registry https://registry.npm.taobao.org
    --配置后验证是否成功
    $ npm config get registry

  • npm 安装包时，临时使用淘宝 npm 镜像：

    1
    $ npm install vue-cli --registry=https://registry.npm.taobao.org

参考

https://www.npmjs.com/

https://www.npmjs.com.cn/

https://npm.taobao.org/

http://www.runoob.com/nodejs/nodejs-tutorial.html