package.json 当中的数字和符号的意义

📋 版本号格式

NPM 采用 语义化版本控制（Semantic Versioning） 规范，版本号格式为：

复制代码

MAJOR.MINOR.PATCH

MAJOR：主版本号
MINOR：次版本号
PATCH：修订号

🎯 版本范围符号

^ 符号 - 兼容补丁和小版本

bash 复制代码

^3.4.0  # 等价于 >=3.4.0 <4.0.0

✅ 允许次版本号和修订版本号增加
❌ 不允许主版本号变化

~ 符号 - 仅兼容补丁版本

bash 复制代码

~3.4.0  # 等价于 >=3.4.0 <3.5.0

✅ 仅允许修订版本号增加
❌ 不允许次版本号和主版本号变化

精确版本

bash 复制代码

3.4.0   # 精确匹配 3.4.0

🎯 完全锁定版本

🌟 通配符版本

x 通配符

bash 复制代码

3.x     # 等价于 >=3.0.0 <4.0.0
3.4.x   # 等价于 >=3.4.0 <3.5.0

* 通配符

bash 复制代码

*       # 匹配所有版本

📊 比较运算符

bash 复制代码

>=3.4.0   # 大于等于 3.4.0
<=3.4.0   # 小于等于 3.4.0
>3.4.0    # 大于 3.4.0
<3.4.0    # 小于 3.4.0

🏷️ 特殊版本标签

标签	说明	使用场景
`latest`	最新稳定版本	生产环境推荐
`next`	下一个主要版本	尝鲜新特性
`beta`	测试版本	功能测试
`alpha`	早期测试版本	开发阶段测试
`workspace`	menorepo中安装的其他的项目	多项目依赖互引

📦 依赖类型详解

以下示例使用 pnpm 包管理器：

1. dependencies - 运行时依赖

csharp 复制代码

pnpm add vue
pnpm add lodash@^4.17.21

🚀 生产环境必需
📱 打包时会包含在最终产物中
🎯 用户安装应用时会自动安装

2. devDependencies - 开发时依赖

csharp 复制代码

pnpm add -D typescript

🛠️ 仅开发阶段使用
📦 不会打包到生产环境
🔧 包括构建工具、测试框架、类型定义等

3. peerDependencies - 对等依赖

sql 复制代码

pnpm add --save-peer vue

实际案例分析：

Element UI (Vue 2)

json 复制代码

{
  "peerDependencies": {
    "vue": "^2.5.17"
  }
}

Element Plus (Vue 3)

json 复制代码

{
  "peerDependencies": {
    "vue": "^3.2.0"
  }
}

核心概念：

🔗 组件库不包含这个依赖
👥 需要使用者主动提供对应版本
⚖️ 避免版本冲突，减少包体积
🎯 确保宿主环境兼容性

4. optionalDependencies - 可选依赖

csharp 复制代码

pnpm add -O fsevents

使用场景：

🔄 降级兼容处理
💪 即使安装失败，代码依然能运行
🛡️ 常用于平台特定的优化包

代码示例：

ini 复制代码

let watcher;
try {
  // 尝试使用高性能的文件监听器
  const chokidar = require('chokidar');
  watcher = chokidar.watch('./src');
} catch (e) {
  // 降级到原生 fs.watch
  const fs = require('fs');
  watcher = fs.watch('./src');
}