共计 3275 个字符，预计需要花费 9 分钟才能阅读完成。
Npm 使用教程
npm（Node Package Manager）是 Node.js 的包管理器，它允许开发者轻松地安装、更新、卸载和管理 Node.js 项目中的依赖包。npm 是 Node.js 生态系统中不可或缺的一部分，极大地简化了项目依赖管理和代码共享的过程。本教程将详细介绍 npm 的安装、基础用法、高级功能以及常见问题解决方案。
一、npm 的安装
1. 安装 Node.js
npm 是 Node.js 的附带组件，因此你首先需要安装 Node.js。Node.js 的官方网站（nodejs.org）提供了各个操作系统的安装包。按照网站上的指示下载并安装 Node.js 后，npm 也会一并安装。
2. 验证 npm 安装
安装完 Node.js 后，你可以通过命令行或终端来验证 npm 是否成功安装。打开命令行或终端，输入以下命令：
npm -v
如果 npm 已正确安装，该命令将返回 npm 的版本号。如果没有返回版本号，可能需要检查 Node.js 是否安装成功，或者重新安装 Node.js。
二、npm 的基础用法
1. 初始化项目
在你的项目文件夹中打开命令行或终端，输入以下命令来初始化一个新的 npm 项目：
npm init
该命令将引导你创建一个 package.json 文件，该文件用于存储项目的元信息和依赖关系。如果你希望使用默认配置快速生成 package.json 文件，可以使用 -y 或--yes选项：
npm init -y
2. 安装依赖
本地安装
使用 npm install 命令来安装一个或多个 npm 包。默认情况下，npm 会将包安装到项目的 node_modules 文件夹中，并在 package.json 文件的 dependencies 字段中添加相应的条目。例如，要安装一个名为 express 的包，你可以输入：
npm install express
或者简写为：
npm i express
如果你想将包安装为开发依赖（仅用于开发环境），可以使用 --save-dev 选项：
npm install package_name> --save-dev
或者简写为：
npm i package_name> -D
npm 5 及以上版本默认将生产依赖添加到dependencies，将开发依赖添加到devDependencies。
全局安装
全局安装是指将一个模块安装到系统目录中，各个项目都可以调用。通常，全局安装只适用于工具模块，比如 eslint 和 gulp。全局安装命令如下：
npm install -g package_name>
或者简写为：
npm i -g package_name>
3. 卸载依赖
如果你不再需要某个 npm 包，可以使用 npm uninstall 命令将其从项目中卸载。例如，要卸载 express 包，你可以输入：
npm uninstall express
或者简写为：
npm un express
如果你想卸载开发依赖，同样可以使用 --save-dev 选项。
4. 更新依赖
随着项目的进展，你可能需要更新一些 npm 包到最新版本。你可以使用 npm update 命令来更新一个或多个包：
npm update package_name>
如果你希望更新所有依赖包，可以删除 node_modules 目录和 package-lock.json（或npm-shrinkwrap.json）文件，然后重新运行npm install。但请注意，这种方法会更新到package.json 中指定的最新版本，而不是 npm 仓库中的最新版本。
5. 运行脚本
在 package.json 文件的 scripts 字段中，你可以定义一些自定义的 npm 脚本。这些脚本可以使用 npm run 命令来执行。例如，你可以定义一个启动服务的脚本：
"scripts": {
"start": "node server.js"
}
然后，在命令行中运行以下命令来启动服务：
npm run start
三、npm 的高级用法（续）
2. npm link
npm link 是一个强大的工具，它允许你在本地开发环境中将某个 npm 包链接到你的项目中，而无需将其发布到 npm 注册中心。这在你正在开发一个库或工具，并希望在其他项目中进行测试时特别有用。
- 链接一个 npm 包到全局：首先，在 npm 包的根目录下运行
npm link。这将创建一个全局链接，指向你的包。 - 在项目中使用全局链接的包：然后，在你想要使用这个包的项目中运行
npm link。这将创建一个从项目node_modules目录到全局链接包的符号链接。
3. 使用 npm scripts 进行构建和测试
在 package.json 的 scripts 部分，你可以定义一系列自定义的 npm 脚本来自动化构建、测试和其他开发任务。这些脚本可以执行任意命令，并且可以利用 npm 的环境变量（如 npm_package_version）来获取包的信息。
-
示例：
"scripts": { "build": "webpack --mode production", "test": "jest", "prepublishOnly": "npm run test && npm run build" }在这个例子中，
build脚本用于生产环境的构建，test脚本用于运行测试，而prepublishOnly脚本在发布前自动运行测试和构建任务。
四、npm 在生产环境中的最佳实践
1. 使用 package-lock.json 或npm-shrinkwrap.json
为了确保项目依赖的一致性和可重复性，npm 5 及以上版本默认生成一个 package-lock.json 文件。这个文件锁定了安装时的依赖版本，确保在不同环境中安装时获得相同的依赖树。如果你使用的是 npm 4 或更早版本，可以考虑使用 npm shrinkwrap 命令来生成 npm-shrinkwrap.json 文件。
2. 审核和更新依赖
- 定期审核依赖：使用工具如
npm audit来检查项目依赖中的安全漏洞。npm audit会扫描package.json和package-lock.json文件中列出的所有依赖，并报告任何已知的安全问题。 - 及时更新依赖：虽然自动更新依赖可能带来风险，但长期不更新也可能导致安全问题或错过重要的性能改进。建议定期评估并更新项目的依赖。
3. 使用 CI/CD 集成 npm
将 npm 集成到持续集成 / 持续部署（CI/CD）流程中，可以自动化测试、构建和部署过程。例如，你可以在每次代码提交时自动运行测试，在合并到主分支时构建并发布新版本。
4. 私有 npm 仓库
对于私有项目或组织，使用私有 npm 仓库（如 Verdaccio、Nexus Repository 等）可以安全地存储和管理私有包。这有助于保护知识产权，并简化跨团队和项目的依赖管理。
5. 缓存和镜像
- 使用 npm 缓存：npm 会自动缓存下载的包，以便在后续安装时更快地恢复。你可以通过
npm cache clean命令来清除缓存，但在大多数情况下，最好让 npm 管理缓存。 - 设置 npm 镜像：对于在中国等网络访问 npm 注册中心较慢的地区，你可以设置 npm 镜像（如淘宝 npm 镜像）来加速包的下载。
五、常见问题解决方案
1. npm 安装速度慢
- 使用 npm 镜像：如上所述，设置 npm 镜像可以显著提高安装速度。
- 增加并发数：npm 默认使用有限的并发数来下载包。你可以通过增加
npm config set fetch-retries 3和npm config set registry-fetch-timeout 30000等配置来优化网络请求。
2. 依赖冲突
- 使用
npm ls命令：该命令可以列出项目的依赖树，帮助你识别和解决依赖冲突。 - 手动调整
package.json：在极端情况下，你可能需要手动调整package.json文件中的依赖版本，以解决冲突。
3. 权限问题
- 全局安装时的权限问题：在 Linux 或 macOS 上，全局安装 npm 包时可能需要 sudo 权限。然而，更好的做法是使用 npm 的
--prefix选项来指定一个全局安装目录，或者使用 nvm（Node Version Manager）来管理 Node.js 和 npm 的安装。
通过遵循这些最佳实践和解决方案，你可以更有效地使用 npm 来管理 Node.js 项目的依赖，并提高项目的可维护性和稳定性。
原文地址: Npm 使用教程
