当前位置：首页 > news >正文

npm包安装与管理：深入解析命令行工具的全方位操作指南，涵盖脚本执行与包发布流程

news 2025/11/3 19:52:38

在这里插入图片描述

npm，全称为Node Package Manager，是专为JavaScript生态系统设计的软件包管理系统，尤其与Node.js平台紧密关联。作为Node.js的默认包管理工具，npm为开发者提供了便捷的方式来安装、共享、分发和管理代码模块。

npm作为JavaScript世界不可或缺的基础设施，极大地促进了代码复用和协作。

一、npm包安装与管理

1. 安装包

命令: npm install <package-name>
作用: 安装指定的npm包作为项目依赖。
例子:
```
$ npm install express
```
默认情况下，这会将包安装在node_modules目录下，并且如果项目中有package.json文件，还会将该包添加到dependencies字段。
全局安装:
```
$ npm install -g <package-name>
```
使用 -g 或 --global 参数进行全局安装，这样可以在系统全局范围内访问这个包，而不是仅限于当前项目。

2. 保存依赖

命令: 自npm 5.0.0以后，--save和--save-dev已经成为默认行为，无需显式指定。
- npm install <package-name> 相当于 npm install <package-name> --save，将包添加到dependencies。
- npm install <package-name> --save-dev 将包添加到devDependencies，适用于开发阶段需要但生产环境中不需要的工具。

3. 更新依赖

命令: npm update <package-name>
作用: 更新指定包至最新版本（符合package.json中指定的版本范围）。
例子:
```
$ npm update express
```

4. 查看已安装包

命令: npm list
作用: 列出当前项目所有已安装的依赖及其版本。
例子:
```
$ npm list
```
npm list --depth=0: 只列出顶级依赖，不显示子依赖。

5. 搜索包

命令: npm search <query>
作用: 在npm仓库中搜索包含给定关键词的包。
例子:
```
$ npm search express
```

6. 清除缓存

命令: npm cache clean --force（旧版）或 npm cache clean --all（新版）
作用: 清除npm的本地缓存。
例子:
```
$ npm cache clean --force
```

7. 版本管理

命令: npm version <semver>
作用: 更新项目版本号（遵循语义化版本控制SemVer规则，如patch、minor、major）。
例子:
```
$ npm version patch
```
npm outdated: 显示项目中过时的依赖包。

8. 卸载包：

- `npm uninstall <package-name>`：卸载本地项目的一个包。
- `npm uninstall -g <package-name>`：卸载全局安装的包。

9.设置和查询配置：

npm config set <key> <value>：设置npm配置项。
npm config get <key>：查询npm配置项的值。
npm config ls：列出所有的npm配置。

10.其他：

npm audit：检查项目依赖是否存在已知安全漏洞。
npm shrinkwrap 或 npm lock（在npm 5+中引入package-lock.json）：锁定依赖版本，确保每次安装都得到一致的结果。

二、npm镜像源设置

在国内使用npm（Node Package Manager）时，由于地理位置和网络限制，直接从npm官方源下载包可能会比较慢。为了提升下载速度和稳定性，很多国内的公司和组织提供了npm的镜像服务。以下是一些国内常用的优秀npm镜像源推荐及使用方法：

淘宝NPM镜像：
- 搜索地址：http://npm.taobao.org/
- Registry 地址：https://registry.npm.taobao.org/
- 使用方法：
  - 临时使用：
```
npm --registry=https://registry.npm.taobao.org install <package-name>
```
  - 持久使用：
```
npm config set registry https://registry.npm.taobao.org
```
- 腾讯云NPM镜像：
  Registry 地址：https://mirrors.cloud.tencent.com/npm/
- 华为云NPM镜像：
  Registry 地址：https://mirrors.huaweicloud.com/repository/npm/
- 阿里云NPM镜像：
  Registry 地址：https://registry.npm.alibaba.com/
cnpmjs镜像：
- Registry 地址：http://r.cnpmjs.org/
- 可以通过cnpm客户端（一个基于npm的增强版命令行工具）来使用它，首先安装cnpm：
```
npm install -g cnpm --registry=https://registry.npm.taobao.org
```
  然后直接使用cnpm替代npm命令。

要检查当前使用的npm镜像源，可以运行以下命令：

npm config get registry

要恢复到官方源，只需设置回官方Registry地址：

npm config set registry https://registry.npmjs.org/

注意：由于互联网服务可能发生变化，请在使用前访问各镜像网站确认最新的使用指南和地址。同时，不同镜像的同步策略和服务状态也可能有所差异，请根据实际需求选择合适的镜像源。

三、npm脚本运行

npm（Node Package Manager）允许用户在package.json文件中定义自定义脚本，这些脚本可以通过npm run命令来执行。这一特性使得项目管理和自动化任务变得极为方便，比如构建项目、运行测试、启动开发服务器、部署应用等等。
- 命令: npm run <script-name>
- 作用: 根据package.json中的scripts字段执行预定义的脚本。
- 例子:

示例1：基本脚本命令

// package.json 文件片段
{"name": "my-project","version": "1.0.0","scripts": {"start": "node app.js", // 启动应用程序"build": "webpack --mode production", // 使用webpack进行生产环境构建"test": "jest", // 运行Jest测试套件"lint": "eslint .", // 使用ESLint检查代码规范"serve": "vue-cli-service serve", // Vue CLI项目启动本地开发服务器"format": "prettier --write '**/*.{js,jsx,json,css,md}'" // 格式化代码},// ... 其他字段
}

如何运行这些脚本？

对于上述package.json文件中的每个脚本，你可以通过如下命令来运行它们：

启动应用程序：

npm run start

其他命令

npm run build //构建项目
npm run test //运行测试
npm run lint //检查代码规范
npm run serve //启动本地开发服务器
npm run format //格式化代码

npm run会创建一个新的shell来执行指定的脚本命令，所以你可以像在shell脚本中那样使用管道(|)、重定向(>或>>)、逻辑运算符(&&或||)等。
可以通过npm run-script <script-name>的方式来代替npm run <script-name>，但后者更为常见和简洁。
有些脚本名称具有特殊含义，例如prebuild和postbuild会在build脚本前后自动执行。
参数传递：若要向脚本传递参数，可以使用--分隔符，例如：npm run my-script -- --arg1 value1 --arg2 value2。

示例2：传递参数和环境变量

在npm脚本中还可以传递参数和使用环境变量。
若要向脚本传递参数，可以使用–分隔符，例如：npm run my-script – --arg1 value1 --arg2 value2。

"scripts": {"env-test": "node script.js $npm_config_env_variable",
}

运行脚本并传入环境变量：

npm run env-test -- --env-variable=value

这里，$npm_config_env_variable将会被替换为--env-variable=value传入的值。

示例3：组合多个命令

如果你需要执行一系列命令，可以使用&&符号连接多个命令，或者使用npm-run-all等第三方包来并行或顺序执行脚本：

"scripts": {"deploy": "npm run build && npm run deploy-to-server",
}

在上述示例中，npm run deploy将会先执行build脚本，成功后再执行deploy-to-server脚本。

通过这种方式，npm脚本极大地增强了项目自动化能力，使得开发者能够更好地组织和执行项目生命周期中的各个步骤。

三. npm包制作发布

创建自己的npm包并成功发布、维护至npm官方网站，可以连接全球范围内的开发者、包作者与使用者，共同推动着Node.js生态的繁荣与发展。

命令: npm publish
作用: 将当前目录下符合npm发布要求的包发布到npm仓库。
前提: 已经登录npm账户 (npm login)，并且当前目录下有合法的package.json和README.md等文件。

具体请查看《如何开发创建自己的npm包并成功发布、维护至npm官方网站》

以上命令仅覆盖了npm部分基础和常用的功能，实际使用时还有许多其他命令可供探索，包括但不限于删除包、查看包信息、链接本地包等。建议查阅npm官方文档获取完整信息。