NPM package 版本管理

NPM package 版本管理

说到npm package 相信很多人都遇到过 修改 package.json 里面version 字段的经历,然而修改的时候相信很多人都是手动修改的,如何能比较优雅的修改呢?

版本号组成

node package版本号由四部分组成:major.minor.patch[-prerelease],比如:1.0.2-beta.1,其中prerelease可选。

在Node.js中,语义化版本(Semantic Versioning)是一种用于管理代码库版本的标准。它使用三个数字(major.minor.patch)来表示版本号,每个数字都有特定的含义。

  • 主版本号(Major):表示不兼容的 API 更改,即当主版本号增加时,代码库中的公共 API 可能会发生重大更改,可能与之前的版本不兼容。

  • 次版本号(Minor):表示向下兼容的功能添加,即当次版本号增加时,代码库中添加了新的功能,但这些新功能不会破坏与之前的版本的兼容性。

  • 修订号(Patch):表示向下兼容的错误修复,即当补丁版本号增加时,代码库中的错误得到了修复,但这些修复不会破坏与之前的版本的兼容性。

  • 先行版本号 (prerelease):带有该版本号的包通常表示在测试阶段,尚未稳定,通常不建议用户安装。

先行版本号的定义:

先行版本号可以被标注在修订版之后,先加上一个连接号再加上一连串以句点分隔的标识符来修饰。标识符必须由 ASCII 字母数字和连接号 [0-9A-Za-z-] 组成,且禁止留白。数字型的标识符禁止在前方补零。先行版的优先级低于相关联的标准版本。被标上先行版本号则表示这个版本并非稳定而且可能无法满足预期的兼容性需求。范例:1.0.0-alpha、1.0.0-alpha.1、1.0.0-0.3.7、1.0.0-x.7.z.92。

  • npm version [<newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease | from-git] 
    
    

npm 提供了自动升级版本号的工具:npm version,该工具会自动修改package.json内的版本号并且会自动 git commit, 因此使用该工具时请保持git status是clear的。

NPM包的先行版本号是指在正式发布之前,开发者可以通过添加特定标识来标记软件包的预发布版本。在版本号中,先行版本号位于主版本号、次版本号和修订号之后,并以连字符或者小数点分隔。先行版本号的目的是让开发者和用户在软件包发布前进行测试和评估,以便及时发现和修复可能存在的问题。

先行版本号的标识可以是任意的,但常见的标识包括:

  1. alpha: 表示软件包的初步开发阶段,通常只有基本功能并且可能存在较多的缺陷。

  2. beta: 表示软件包已经经过一些测试,并且功能比较完整,但仍然可能存在一些缺陷。

  3. rc(release candidate): 表示软件包已经相对稳定,并且已经具备了所有功能,但仍然需要最后的测试和确认。

  4. pre: 表示除了上述常见的标识之外的其他先行版本号。

使用先行版本号,开发者可以让用户更早地尝试他们的软件包,并从用户的反馈中获得宝贵的改进意见。同时,用户也能够提前了解即将发布的软件包的功能和特性,以便做出合适的决策。

下面是一些具体操作

# 给当前包的版本设置为 1.0.0
npm version 1.0.0

# 运行下面命令将由1.0.0变为1.0.1 修订号升级:v1.0.1
npm version patch

# 运行下面命令将由1.0.0变为1.1.0  次版本号升级:v1.1.0
npm version minor

# 运行下面命令将由1.0.0变为2.0.0  主版本号升级:v2.0.0
npm version major

# 运行下面命令将由1.0.0变为 2.0.0-rc.0
npm version premajor --preid=rc

# 运行下面命令将由1.0.0变为 1.1.0-beta.0
npm version preminor --preid=beta

# 运行下面命令将由1.0.0变为 1.0.1-alpha.0
npm version prepatch --preid=alpha

# 运行下面命令将由1.0.0变为 1.0.1-0  如果是1.0.1-alpha.0将变为1.0.1-alpha.1
npm version prerelease

# 再次运行会由 1.0.1-0变为 1.0.1-1  如果是1.0.1-alpha.1将变为1.0.1-alpha.2
npm version prerelease

# 运行下面命令将由1.0.1-1变为 2.0.0   7.0.0-beta.0=>7.0.0
npm version major

# 运行下面命令将由 1.1.0-beta.0 变为 1.1.0
npm version minor

# 运行下面命令将由 1.0.1-alpha.变为 to 1.0.1
npm version patch

npm install ,会安装哪个版本的**package** 最新版本?

npm install ,会安装哪个版本的package 答案是latest指向的version。

npm install vue ===  npm install vue@latest

当我们修改一个npm包的时候 不想让线上用户收到影响可以发布一个beta版本

npm publish --tag beta

这样用户执行npm i的时候是安装不上的需要运行下面的命令

npm install vue@beta

这样可以避免 用户执行npm i 后使用beta版本的代码

通过npm dist-tag ls指令可以查看某个package的所有tag

以vue为例:

> npm dist-tag ls vue
alpha: 3.3.0-alpha.13
beta: 3.3.0-beta.5
csp: 1.0.28-csp
latest: 3.3.4
legacy: 2.6.14
next: 3.2.36
preview: 3.0.3
v2-alpha: 2.7.0-alpha.12
v2-beta: 2.7.0-beta.8
v2-latest: 2.7.14

这也解释了为什么vue刚出来的时候没有成为默认版本的时候需要运行 npm i vue@next next 为标签名字 和beta类似。说明到时发布的时候使用的是命令

npm publish --tag next

具体操作流程图


WechatIMG802.jpeg

npm-package.jpg

参考

https://github.com/canvasT/blog/issues/2

https://docs.npmjs.com/cli/v8/commands/npm-version

https://juejin.cn/post/7225414542612185143

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,366评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,521评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 165,689评论 0 356
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,925评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,942评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,727评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,447评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,349评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,820评论 1 317
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,990评论 3 337
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,127评论 1 351
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,812评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,471评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,017评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,142评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,388评论 3 373
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,066评论 2 355

推荐阅读更多精彩内容