npm(全称NodePackageManager)是包管理工具,随着Node.js的安装包一起被安装到了用户的电脑上。
在终端中执行npm -v命令,来查看npm包管理工具的版本号。
npm -v
1. 包的分类
使用npm包管理工具下载的包,共分为两大类,项目包和全局包。
1.1 项目包
那些被安装到项目的node_modules目录中的包,都是项目包。项目包又分为两类,分别是:
(1)开发依赖包
被记录到devDependencies节点中的包,只在开发期间会用到
npm i 包名 -D
(2)核心依赖包
被记录到dependencies节点中的包,在开发期间和项目上线之后都会用到
npm i 包名
1.2 全局包
在执行npm install命令时,如果提供了-g参数,则会把包安装为全局包。全局包会被安装到C:\Users\用户目录\AppData\Roaming\npm\node_modules目录下。
(1)全局安装指定的包
npm i 包名 -g
(2) 卸载全局安装的包
npm uninstall 包名 -g
注意:
只有工具性质的包,才有全局安装的必要性,因为它们提供了好用的终端命令。
判断某个包是否需要全局安装后才能使用,可以参考官方提供的使用说明即可。
2. 在项目中安装包的命令
2.1 安装包
npm install 包的完整名称
2.2 安装包简写
npm i 包的完整名称
2.3 安装指定版本的包
npm i moment@2.22.2
2.4 安装包后文件更新
初次装包完成后,在项目文件夹下多一个叫做node_modules的文件夹和package-lock.json的配置文件。
其中:
node_modules文件夹用来存放所有已安装到项目中的包,require()导入第三方包时,就是从这个目录中查找并加载包。
package-lock.json配置文件用来记录node_modules目录下的每一个包的下载信息,例如包的名字、版本号、下载地址等。
注意:程序员不要手动修改node_modules或package-lock.json文件中的任何代码,npm包管理工具会自动维护它们。
2.5 一次性安装所有的包
可以运行 npm install 命令(或 npm i)一次性安装所有的依赖包:
npm install
注意:
- 执行 npm install 命令时,npm 包管理工具会先读取 package.json 中的 dependencies 节点
- 读取到记录的所有依赖包名称和版本号后,npm 包管理工具会把这些包一次性下载到项目中
2.6 卸载包
可以运行npm uninstall命令,来卸载指定的包:
npm uninstall moment
注意:npm uninstall 命令执行成功后,会把卸载的包,自动从 package.json 的 dependencies 中移除掉。
2.7 devDependencies节点
如果某些包只在项目开发阶段会用到,在项目上线之后不会用到,则建议把这些包记录到devDependencies节点中。
与之对应的,如果某些包在开发和项目上线之后都需要用到,则建议把这些包记录到dependencies节点中。
(1)安装指定的包,并记录到 devDependencies 节点中
npm install 包名 --save -dev
(2)简写
npm i 包名 -D
3. 解决下包速度慢的问题
3.1 切换npm的下包镜像源
# 查看当前的下包镜像源
npm config get registry
#将下包的镜像源切换为淘宝镜像源
npm config set registry=https://registry.npm.taobao.org/
# 检查镜像源是否下载成功
npm config get registry
3.2 切换npm的下包镜像源
安装nrm工具,利用nrm的终端命令,可以快速查看和切换下包的镜像源
# 通过 npm 包管理器,将 nrm 安装为全局可用的工具
npm i nrm -g
#查看所有可用的镜像源
nrm ls
# 将下包的镜像源切换为 taobao 镜像
nrm use taobao
4. 使用i5ting_toc命令快速生成MD目录
(1)安装
npm install -g i5ting_toc
(2)执行
i5ting_toc -f sample.md -o