包的安装、配置、使用

一、包的安装

安装（install）即下载包
由于 npm 的官方 registry 服务器位于国外，可能受网速影响导致下载缓慢或失败。因此，安装好 npm 之后，需要重新设置 registry 的地址为国内地址。目前，淘宝 https://registry.npm.taobao.org 提供了国内的 registry 地址，先设置到该地址。设置方式为npm config set registry https://registry.npm.taobao.org。设置好后，通过命令npm config get registry进行检查

1.本地安装

使用命令npm install 包名或npm i 包名即可完成本地安装
本地安装的包出现在当前目录下的node_modules目录中

随着开发的进展，node_modules目录会变得异常庞大，目录下的内容不适合直接传输到生产环境，因此通常使用.gitignore文件忽略该目录中的内容
本地安装适用于绝大部分的包，它会在当前目录及其子目录中发挥作用
通常在项目的根目录中使用本地安装
安装一个包的时候，npm 会自动管理依赖，它会下载该包的依赖包到node_modules目录中
如果本地安装的包带有 CLI，npm 会将它的 CLI 脚本文件放置到node_modules/.bin下，使用命令npx 命令名即可调用

2.全局安装

全局安装的包放置在一个特殊的全局目录，该目录可以通过命令npm config get prefix查看

使用命令npm install --global 包名或 npm i -g 包名
重要：全局安装的包并非所有工程可用，它仅提供全局的 CLI 工具
如在本地安装的mocha，本地安装无法全局只用，全局安装后就能全局使用
大部分情况下，都不需要全局安装包，除非：

1. 包的版本非常稳定，很少有大的更新
2. 提供的 CLI 工具在各个工程中使用的非常频繁
3. CLI 工具仅为开发环境提供支持，而非部署环境

二、包的配置

目前遇到的问题：

1. 拷贝工程后如何还原？
2. 如何区分开发依赖和生产依赖？
3. 如果自身的项目也是一个包，如何描述包的信息

以上这些问题都需要通过包的配置文件解决

1.配置文件

npm 将每个使用 npm 的工程本身都看作是一个包，包的信息需要通过一个名称固定的配置文件来描述
配置文件的名称固定为：package.json

可以手动创建该文件，而更多的时候，是通过命令npm init创建的
配置文件中可以描述大量的信息，包括：

• name：包的名称，该名称必须是英文单词字符，支持连接符
• version：版本
  • 版本规范：主版本号.次版本号.补丁版本号
  • 主版本号：仅当程序发生了重大变化时才会增长，如新增了重要功能、新增了大量的API、技术架构发生了重大变化
  • 次版本号：仅当程序发生了一些小变化时才会增长，如新增了一些小功能、新增了一些辅助型的API
  • 补丁版本号：仅当解决了一些 bug 或 进行了一些局部优化时更新，如修复了某个函数的 bug、提升了某个函数的运行效率
• description：包的描述
• homepage：官网地址
• author：包的作者，必须是有效的 npm 账户名，书写规范是 account <mail>，例如：zhangsan <zhangsan@gmail.com>，不正确的账号和邮箱可能导致发布包时失败
• repository：包的仓储地址，通常指 git 或 svn 的地址，它是一个对象
  • type：仓储类型，git 或 svn
  • url：地址
• main：包的入口文件，使用包的人默认从该入口文件导入包的内容
• keywords: 搜索关键字，发布包后，可以通过该数组中的关键字搜索到包

使用npm init --yes或npm init -y可以在生成配置文件时自动填充默认配置

手动创建

快速创建

2.保存依赖关系

大部分时候，我们仅仅是开发项目，并不会把它打包发布出去，尽管如此，我们仍然需要package.json文件
package.json文件最重要的作用，是记录当前工程的依赖

• dependencies：生产环境的依赖包
• devDependencies：仅开发环境的依赖包

配置好依赖后，使用下面的命令即可安装依赖

## 本地安装所有依赖 dependencies + devDependencies
npm install
npm i

## 仅安装生产环境的依赖 dependencies
npm install --production

这样一来，代码移植就不是问题了，只需要移植源代码和package.json文件，不用移植node_modules目录，然后在移植之后通过命令即可重新恢复安装

为了更加方便的添加依赖，npm支持在使用install命令时，加入一些额外的参数，用于将安装的依赖包保存到package.json文件中

涉及的命令如下

## 安装依赖到生产环境
npm i 包名
npm i --save 包名//早期版本
npm i -S 包名

## 安装依赖到开发环境
npm i --save-dev 包名
npm i -D 包名

自动保存的依赖版本，例如^15.1.3，这种书写方式叫做语义版本号（semver version），具体规则后续讲解

三、包的使用

nodejs 对 npm 支持非常良好

当使用 nodejs 导入模块时，如果模块路径不是以 ./ 或 …/ 开头，则 node 会认为导入的模块来自于 node_modules 目录，例如：

var _ = require("lodash");//一些特殊名字，会使用node内置模块，即重名了

node_modules/lodash.js
node_modules/lodash/入口文件

若当前目录没有这样的文件，则会回溯到上级目录按照同样的方式查找
如果到顶级目录都无法找到文件，则抛出错误（一般情况将包安装到根目录下，这样一般情况都能都找到目标文件）

1. 查看导入包的package.json文件，读取main字段作为入口文件
2. 若不包含main字段，则使用index.js作为入口文件
   

入口文件的规则同样适用于自己工程中的模块
在 node 中，还可以手动指定路径来导入相应的文件，这种情况比较少见