package.json 中版本号遵循什么原则

package.json 中的 version 一般遵循 语义化版本(Semantic Versioning,SemVer) 规范。

规范官网:

Semantic Versioning 2.0.0

格式:

json 复制代码
{
  "version": "1.2.3"
}

对应:

复制代码
MAJOR.MINOR.PATCH
主版本号.次版本号.修订号

1. PATCH(修订号)

复制代码
1.0.0 → 1.0.1

适用于:

  • Bug 修复
  • 性能优化
  • 文档修改
  • 内部实现调整

且:

复制代码
不会影响现有使用方式
不会破坏兼容性

例如:

复制代码
1.0.0
↓
修复表格滚动异常
↓
1.0.1

2. MINOR(次版本号)

复制代码
1.0.0 → 1.1.0

适用于:

复制代码
新增功能
新增组件
新增 API
新增配置项

同时:

复制代码
向后兼容

例如你的组件库:

复制代码
1.0.0

新增:

xml 复制代码
<TfChart />

升级:

复制代码
1.1.0

老项目无需修改代码。


3. MAJOR(主版本号)

复制代码
1.0.0 → 2.0.0

适用于:

复制代码
破坏性变更
Breaking Change

例如:

原来:

ini 复制代码
<TfTable :data="data" />

改成:

ini 复制代码
<TfTable :rows="data" />

旧代码失效:

复制代码
1.x.x
↓
2.0.0

常见版本演进

复制代码
1.0.0
1.0.1
1.0.2
1.0.3

1.1.0
1.1.1
1.1.2

1.2.0

2.0.0

0.x.x 特殊规则

很多组件库初期:

json 复制代码
{
  "version": "0.1.0"
}

表示:

复制代码
开发阶段
API 可能随时变化
不保证稳定

例如:

复制代码
0.1.0
0.2.0
0.3.0

即使有 Breaking Change,也不一定升主版本。

很多开源项目都会经历:

复制代码
0.1.0
0.5.0
0.9.0
1.0.0

预发布版本

Alpha

复制代码
1.0.0-alpha.1

表示:

复制代码
内部开发版
功能未完成

Beta

matlab 复制代码
1.0.0-beta.1

表示:

复制代码
功能基本完成
开始测试

RC

复制代码
1.0.0-rc.1

表示:

sql 复制代码
Release Candidate
发布候选版

通常:

复制代码
1.0.0-rc.1
↓
1.0.0-rc.2
↓
1.0.0

npm 常用升级命令

修订版本:

复制代码
npm version patch

1.0.0 → 1.0.1

次版本:

复制代码
npm version minor

1.0.0 → 1.1.0

主版本:

复制代码
npm version major

1.2.3 → 2.0.0

相关推荐
Flynt10 小时前
AI 写的 Three.js 大屏,为什么越跑越卡?我在 Node 里复现了它的内存曲线
前端·ai编程·three.js
一个游离的指针13 小时前
Vue2:vue-router
前端·javascript·vue.js
火山引擎和TA的超级拍档们15 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
JavaGuide15 小时前
Gemini 真的变强了,写代码做视频的能力接近 Claude Opus5.5 了!
前端·ai编程
niceyayale15 小时前
WebRTC 延迟怎么调试:从 ICE 到 jitter buffer 的六个观测点
前端
aleimu15 小时前
Windows 11 右键打开 Cmder 2.0:从找不到菜单到默认使用 Cmder
前端·人工智能·后端
tryCbest15 小时前
Vue系列——第 20 篇:Vue Router 4——路由管理完全指南(上)
前端·javascript·vue.js
feixing_fx15 小时前
原始类型与引用类型:赋值时到底复制了什么
开发语言·前端·javascript·前端框架
一条破秋裤16 小时前
【1115】【多线程】【笔记】
前端·chrome·笔记
黑十16 小时前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能