npm 简介

从 java 开发者转移到 react 开发者,第一次相对系统地了解 npm,主要包括介绍、常用命令、package.json 格式和 registry 配置,可以快速搭建开发环境

介绍

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

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

常用命令

  • npm install npm -g // 更新 npm
  • npm help & npm help <command>
  • npm -v
  • npm install

    • npm install // 根据 package.json 安装
    • npm install <module name> // 安装指定 module,var express = require(‘express’) 引用
  • npm update <module name> // 更新指定module
  • npm uninstall <module name>
  • npm link <module name>
  • npm search <module name>
  • npm ls <module name>
  • npm init
  • npm publish
  • npm cache clear // 清空NPM本地缓存,用于对付使用相同版本号发布新版本代码的人
-g:全局生效,否则本地生效

package.json

  • package.json 位于模块的目录下,用于定义包的属性
  • 属性说明

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

    • npm 的预定义脚本:npm scripts 查看全部预定义命令

      • npm start = npm run start = npm run-script start = <package.json.scripts.start>
    • 开发者自定义脚本(非 npm 预定义)

      • npm run start = npm run-script start = <package.json.scripts.start>
  • package-lock.json

    • 在 npm install 时自动生成,可以保证每次安装的依赖都是一样的。
    • 解决某些 module 的发布,不满足语义版本号要求时,导致额外的适配、测试的成本
    • 最后更新:当package.json文件有发生变更时,使用package.json作为依赖的来源
Npm maintainers added a change that causes package.json to overrule the package-lock if package.json has been updated. 
npm中使用的语义版本号

语义版本号分为X.Y.Z三位,分别代表主版本号、次版本号和补丁版本号。当代码变更时,版本号按以下原则更新。
1 如果只是修复bug,需要更新Z位。
2 如果是新增了功能,但是向下兼容,需要更新Y位。
3 如果有大变动,向下不兼容,需要更新X位。

npm registry 配置

  • registry 指 npm 包的数据库
  • 默认镜像:http://registry.npmjs.org
  • 当前镜像:npm config get registry
  • 设置镜像:

    • 通过config命令:npm config set registry <url> info underscore
    • 命令行指定:npm —registry <url> info underscore
    • 编辑 ~/.npmrc:registry = <url>
    • 使用 nrm 管理 registry 地址

      1. npm install -g nrm
      2. nrm add <nameA> <urlA> & nrm add <nameB> <urlB>
      3. nrm use nameA & nrm use nameB
  • 可选择镜像


参考文档

评论

暂无评论