从 0 到上线 网站建设实训课
总览/ 课程地图/ S1 版本管理

M06版本号单一来源与发版

所属路径 B / C 第 6 / 31 讲 S1 版本管理
版本号只许有一个源头
学完能独立完成一次发版，并自查版本号四处一致

01为什么重要

版本号一旦有两个出处，就一定会漂移。单一来源的意义不是好看，是让「线上跑的是哪一版」这个问题有唯一答案。

02要讲清的 3 件事核心要点

  • 版本号只在 package.json 一处，构建时注入前端
  • annotated tag 与自动创建 Release
  • 发版三部曲：推 main → 打 tag → push tag

03照着做：4 步操作顺序

  1. 确认版本号只写在 package.json 一处
  2. 推 main，等构建与部署完成
  3. 打 annotated tag，写一句说明
  4. push tag，核对 Release 自动建出来
git tag -a v0.1.0 -m "首版"
git push origin v0.1.0
git ls-remote --tags origin | tail -3

04产出物与验收做完怎么算过

产出物

一次完整发版：tag + Release + 线上可查版本

验收判据

可验四方一致性审计退出码 0（版本文件 / tag / Release / 线上哨兵）

05练习15 分钟内可做完

故意漏掉 push tag，观察会发生什么——答案是没有任何报错。

06最容易踩的坑

漏 push tag 静默无感；比对时忘剥 tag 的 v 前缀会误判不一致
后果：漏了 push tag：本地有标签、远端没有、Release 也不建——而且全程不报错，你以为发了。

07自检表进度存在本机浏览器

0 / 6

08本讲术语全部 28 条

  • 单一来源：同一个信息只允许有一个权威出处（如版本号只写在 package.json），别处都从它派生。
  • tag 与 Release：tag 是给某次提交起的固定名字（如 v1.2.0）；Release 是挂在 tag 上的发布页，可附说明与附件。