教程 · 编程上线
CHANGELOG：升级前读 breaking
写/读变更日志，升级前知道破坏性变更和迁移。
前置：版本变更列表。
材料：CHANGELOG、GitHub Release、测试环境
材料：CHANGELOG、GitHub Release、测试环境
步骤
1. 分类
Added/Changed/Fixed/Deprecated/Removed/Security。
2. 标 breaking
单独列，写迁移步骤/旧 API 对照。
3. 写验证/回滚
测试命令/回滚版本。
4. 版本号
semver：major/minor/patch 与变更匹配。
5. 升级前读
不要只看版本号；小项目验证再全量。
做完检查
- breaking 单独。
- 迁移/回滚。
- 版本号匹配。
常见错误
- 漏 breaking。
- 没回滚。
- 版本号乱。
相关工具
配套模板
同类教程
本地能跑线上 404：先查文件名大小写，再查构建产物
定位大小写、扩展名和路径别名导致的资源 404，用构建产物和大小写敏感环境验证修复。
查看 →密钥被打进了前端包：先分清公开变量和私密变量
识别构建时被内联到前端的变量，把密钥移到服务端并轮换已泄露的凭证。
查看 →单页应用刷新就 404：把未知路径回退到 index.html
配置服务器或托管平台的路由回退规则，让前端路由的深链接刷新和直接访问都能正常打开。
查看 →更新时间：2026-10-29 · 平台规则/软件版本会变；操作前保留原件，以实际页面为准。
跨库学习路径
按共同关键词匹配，不是随机推荐；从任务到提示词/教程/项目继续走。