包管理工具

一、概念介绍

1.1 包是什么

『包』英文单词是 package ，代表了一组特定功能的源码集合

1.2 包管理工具

管理『包』的应用软件，可以对「包」进行 下载安装， 更新，删除， 上传等操作

借助包管理工具，可以快速开发项目，提升开发效率

包管理工具是一个通用的概念，很多编程语言都有包管理工具，所以 掌握好包管理工具非常重要

1.3 常用的包管理工具

下面列举了前端常用的包管理工具

  • npm
  • yarn
  • cnpm

二、npm

npm 全称 Node Package Manager ，翻译为中文意思是『Node 的包管理工具』

npm 是 node.js 官方内置的包管理工具，是 必须要掌握住的工具

2.1 npm 的安装

node.js 在安装时会 自动安装 npm，所以如果你已经安装了 node.js，可以直接使用 npm

可以通过 npm -v 查看版本号测试，如果显示版本号说明安装成功，反之安装失败

image-20260303185414213

2.2 npm 基本使用

2.2.1 初始化

创建一个空目录，然后以此目录作为工作目录 启动命令行工具，执行 npm init

image-20260303185456130

npm init 命令的作用是将文件夹初始化为一个『包』， 交互式创建 package.json 文件

package.json 是包的配置文件，每个包都必须要有 package.json

package.json 内容示例：

1
2
3
4
5
6
7
8
9
10
11
{
"name": "01_npm",                                                
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "",
"license": "ISC
}

属性翻译

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"name": "1-npm",      
#包的名字
"version": "1.0.0",   #包的版本
"description": "",    
#包的描述
"main": "index.js",   #包的入口文件
"scripts": {          
#脚本配置
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "",       #作者  
"license": "ISC"      #开源证书
}

[!CAUTION]

初始化的过程中还有一些注意事项：

  1. package name ( 包名) 不能使用中文、大写，默认值是文件夹的名称,所以文件夹名称也不能使用中文和大写
  2. version ( 版本号)要求x.x.x 的形式定义，x必须是数字，默认值是 1.0.0
  3. ISC 证书与 MIT 证书功能上是相同的，关于开源证书扩展阅读http://www.ruanyifeng.com/blog/2011/05/how_to_choose_free_software_licenses.html
  4. package.json 可以手动创建与修改
  5. 使用 npm init -y 或者 npm init –yes 极速创建package.json

2.2.2 搜索包

搜索包的方式有两种

1.命令行 『npm s/search 关键字』

  1. 网站搜索 网址是 https://www.npmjs.com/

2.2.3 下载安装包

我们可以通过 npm install 和 npm i 命令安装包

1
2
3
4
5
6
# 格式
npm install <包名>
npm i <包名> 
# 示例
npm install uniq
npm i uniq

运行之后文件夹下会增加两个资源

  • node_modules 文件夹 存放下载的包
  • package-lock.json 包的锁文件 ，用来锁定包的版本

[!CAUTION]

安装 uniq 之后， uniq 就是当前这个包的一个依赖包，有时会简称为依赖

比如我们创建一个包名字为 A，A 中安装了包名字是 B，我们就说 B 是 A 的一个依赖包，也会说A依赖B

2.2.4 require 导入 npm 包基本流程

  1. 在当前文件夹下 node_modules 中寻找同名的文件夹
  2. 在上级目录中下的 node_modules 中寻找同名的文件夹，直至找到磁盘根目录

2.3 生产环境与开发环境

开发环境是程序员 专门用来写代码的环境，一般是指程序员的电脑，开发环境的项目一般只能程序员自己访问

生产环境是项目代码正式运行的环境，一般是指正式的服务器电脑，生产环境的项目一般每个客户都可以访问

2.4 生产依赖与开发依赖

我们可以在安装时设置选项来区分依赖的类型，目前分为两类：

类型 命令 补充
生产依赖 npm i-S uniq npm i –save uniq -S 等效于 –save，-S 是默认选项;包信息保存在 package.json 中dependencies属性
开发依赖 npm i -D less npm i –save-dev less -D 等效于 –save-dev 包信息保存在 package.json 中 devDependencies 属性

2.5 全局安装

我们可以执行安装选项 -g 进行全局安装

1
npm i -g nodemon

全局安装完成之后就可以在命令行的任何位置运行 nodemon 命令

该命令的作用是 自动重启 node 应用程序

[!IMPORTANT]

说明： 全局安装的命令不受工作目录位置影响 可以通过 npm root -g 可以查看全局安装包的位置 不是所有的包都适合全局安装， 只有全局类的工具才适合，可以通过查看包的官方文档来确定

2.5.1 修改 windows 执行策略

image-20260303191548308

windows 默认不允许 npm 全局命令执行脚本文件，所以需要修改执行策略

image-20260303191618592

键入命令 set-ExecutionPolicy remoteSigned

image-20260303191635209

键入 A 然后敲回车

如果不生效，可以尝试重启 vscode

2.5.2 环境变量 Path

Path 是操作系统的一个环境变量，可以设置一些文件夹的路径，在当前工作目录下找不到可执行文件 时，就会在环境变量 Path 的目录中挨个的查找，如果找到则执行，如果没有找到就会报错

image-20260303191723214

2.6 安装包依赖

在项目协作中有一个常用的命令就是 npm i ，通过该命令可以依据package.json 和 package-lock.json的依赖声明安装项目依赖

1
2
npm i 
npm install

2.7 安装指定版本的包

项目中可能会遇到版本不匹配的情况，有时就需要安装指定版本的包，可以使用下面的命令的

1
2
3
4
## 格式
npm i <包名@版本号>
## 示例
npm i jquery@1.11.2

2.8 删除依赖

项目中可能需要删除某些不需要的包，可以使用下面的命令

1
2
3
4
5
## 局部删除
npm remove uniq
npm r uniq
## 全局删除
npm remove -g nodemon

2.9 配置命令别名

通过配置命令别名可以更简单的执行命令

配置 package.json 中的 scripts 属性 

1
2
3
4
5
6
7
8
9
10
11
{
.
.
.
"scripts": {
"server": "node server.js",
"start": "node index.js",
},
.
.
}

配置完成之后，可以使用别名执行命令

1
2
npm run server
npm run start

不过 start 别名比较特别，使用时可以省略 run

1
npm start

三、cnpm

3.1 介绍

cnpm 是一个淘宝构建的 npmjs.com 的完整镜像，也称为『淘宝镜像』，网址https://npmmirror.com/

cnpm 服务部署在国内 阿里云服务器上， 可以提高包的下载速度

官方也提供了一个全局工具包 cnpm ，操作命令与 npm 大体相同

3.2 安装

我们可以通过 npm 来安装 cnpm 工具

1
npm install -g cnpm --registry=https://registry.npmmirror.com

3.3 操作命令

功能 命令
初始化 cnpm init / cnpm init
安装包 cnpm i uniq cnpm i -S uniq cnpm i -D uniq cnpm i -g nodemon
安装项目依赖 cnpm i
删除 cnpm r uniq

3.4 npm 配置淘宝镜像

用 npm 也可以使用淘宝镜像，配置的方式有两种

3.4.1 直接配置

1
npm config set registry https://registry.npmmirror.com/

3.4.2 工具配置

使用 nrm 配置 npm 的镜像地址 npm registry manager

1
2
3
npm i -g nrm
nrm use taobao
npm config list

检查 registry 地址是否为 https://registry.npmmirror.com/ , 如果是则表明成功

四、yarn

image-20260303192737525

4.1 yarn 介绍

yarn 是由 Facebook 在 2016 年推出的新的 Javascript 包管理工具，官方网址：https://yarnpkg.com/

4.2 yarn 特点

yarn 官方宣称的一些特点

  • 速度超快：yarn 缓存了每个下载过的包，所以再次使用时无需重复下载。 同时利用并行下载以最大 化资源利用率，因此安装速度更快
  • 超级安全：在执行代码之前，yarn 会通过算法校验每个安装包的完整性
  • 超级可靠：使用详细、简洁的锁文件格式和明确的安装算法，yarn 能够保证在不同系统上无差异的 工作

4.3 yarn 安装

我们可以使用 npm 安装 yarn

1
npm i -g yarn

4.4 yarn 常用命令

功能 命令
初始化 yarn init / yarn init -y
安装包 yarn add uniq 生产依赖 yarn add less –dev 开发依赖 yarn global add nodemon 全局安装
删除包 yarn remove uniq 删除项目依赖包 yarn global remove nodemon 全局删除包
安装项目依赖 yarn
运行命令别名 yarn <别名> # 不需要添加 run

五、管理发布包

5.1 创建与发布

我们可以将自己开发的工具包发布到 npm 服务上，方便自己和其他开发者使用，操作步骤如下：

  1. 创建文件夹，并创建文件 index.js， 在文件中声明函数，使用 module.exports 暴露

  2. npm 初始化工具包，package.json 填写包的信息 (包的名字是唯一的)

  3. 注册账号 https://www.npmjs.com/signup

  4. 激活账号 （ 一定要激活账号）

  5. 修改为官方的官方镜像 (命令行中运行 nrm use npm )

  6. 命令行下 npm login 填写相关用户信息

  7. 命令行下 npm publish 提交包

5.2 更新包

后续可以对自己发布的包进行更新，操作步骤如下

  1. 更新包中的代码

  2. 测试代码是否可用

  3. 修改 package.json 中的版本号

  4. 发布更新npm publish

5.3 删除包

执行如下命令删除包

npm unpublish --force

NodeJS学习笔记
#nodejs
包管理工具
http://example.com/2025/10/09/包管理工具/
作者
Guo HL
发布于
2025年10月9日
许可协议