编辑“︁JavaScript包管理器”︁

= JavaScript包管理器 =

'''JavaScript包管理器'''是用于管理项目依赖项的工具，允许开发者安装、更新、配置和卸载第三方库（称为“包”或“模块”）。它们在现代JavaScript开发中至关重要，帮助开发者高效管理代码库的依赖关系，并确保项目的可维护性和一致性。

== 介绍 ==
在JavaScript生态系统中，包管理器负责处理以下任务：
* 从公共或私有仓库下载和安装依赖项。
* 解析依赖关系并确保版本兼容性。
* 提供脚本运行环境（如测试、构建等）。
* 管理项目的元数据（如`package.json`）。

最常见的JavaScript包管理器包括：
* [[npm]]（Node Package Manager）
* [[Yarn]]
* [[pnpm]]

== 核心概念 ==
=== 包（Package） ===
一个包通常是一个包含代码、配置和元数据的目录，其结构由`package.json`文件定义。例如：
<syntaxhighlight lang="json">
{
  "name": "example-package",
  "version": "1.0.0",
  "dependencies": {
    "lodash": "^4.17.21"
  }
}
</syntaxhighlight>

=== 依赖关系（Dependencies） ===
依赖关系分为几种类型：
* '''生产依赖（dependencies）'''：项目运行时必需的包。
* '''开发依赖（devDependencies）'''：仅在开发阶段需要的包（如测试工具）。
* '''对等依赖（peerDependencies）'''：宿主环境必须提供的包。

== 主要包管理器对比 ==
{| class="wikitable"
|-
! 特性 !! npm !! Yarn !! pnpm
|-
| 安装速度 || 中等 || 快 || 极快
|-
| 磁盘空间占用 || 高 || 中等 || 低（使用硬链接）
|-
| 离线模式 || 支持 || 支持 || 支持
|-
| 工作区支持 || 有（v7+） || 有 || 有
|}

== 基本使用示例 ==
=== npm ===
安装一个包：
<syntaxhighlight lang="bash">
npm install lodash
</syntaxhighlight>

安装开发依赖：
<syntaxhighlight lang="bash">
npm install --save-dev jest
</syntaxhighlight>

=== Yarn ===
初始化项目：
<syntaxhighlight lang="bash">
yarn init
</syntaxhighlight>

添加依赖：
<syntaxhighlight lang="bash">
yarn add react
</syntaxhighlight>

=== pnpm ===
安装依赖（使用高效存储）：
<syntaxhighlight lang="bash">
pnpm add vue
</syntaxhighlight>

== 依赖解析机制 ==
包管理器使用语义化版本控制（SemVer）来管理依赖关系。例如：
* <code>^1.2.3</code> 允许更新次要版本和补丁版本。
* <code>~1.2.3</code> 仅允许更新补丁版本。

<mermaid>
graph TD
    A[项目] --> B[包A v1.2.0]
    A --> C[包B v2.1.0]
    B --> D[包C ^1.1.0]
    C --> D[包C ~1.2.0]
</mermaid>

== 实际应用案例 ==
=== 场景：创建React应用 ===
1. 使用`create-react-app`初始化项目：
<syntaxhighlight lang="bash">
npx create-react-app my-app
</syntaxhighlight>

2. 添加路由库：
<syntaxhighlight lang="bash">
cd my-app
npm install react-router-dom
</syntaxhighlight>

3. 更新所有依赖：
<syntaxhighlight lang="bash">
npm update
</syntaxhighlight>

== 高级主题 ==
=== 锁定文件 ===
包管理器生成锁定文件（如`package-lock.json`、`yarn.lock`）来确保安装一致性。例如：
<syntaxhighlight lang="json">
{
  "name": "my-app",
  "version": "1.0.0",
  "lockfileVersion": 2,
  "requires": true,
  "packages": {
    "": {
      "dependencies": {
        "react": "^18.2.0"
      }
    }
  }
}
</syntaxhighlight>

=== 私有仓库管理 ===
可通过`.npmrc`配置私有仓库：
<syntaxhighlight lang="ini">
registry=https://registry.npmjs.org/
@my-org:registry=https://npm.pkg.github.com/
</syntaxhighlight>

== 常见问题 ==
'''Q: 如何解决依赖冲突？'''
A: 使用`npm ls <package>`查看依赖树，然后通过`resolutions`（Yarn）或手动更新版本解决。

'''Q: 全局安装和本地安装有何区别？'''
A: 全局安装（`-g`）适用于工具类包（如`nodemon`），本地安装则专属于当前项目。

== 数学表示 ==
依赖关系可表示为有向无环图（DAG）：
<math>
G = (V, E), \text{其中 } V \text{是包集合}, E \text{是依赖关系}
</math>

== 总结 ==
JavaScript包管理器是现代开发的基石，理解它们的工作原理能显著提升开发效率。初学者应从npm开始，随着项目复杂度增加再考虑Yarn或pnpm的高级功能。

[[Category:编程语言]]
[[Category:JavaScript]]
[[Category:Javascript工具与环境]]