依赖长期不更新会带来安全风险和维护成本，但一次性升级过多也容易引发回归。本文给出一套更稳妥的更新流程。
目录
更新包依赖
推荐使用 npm-check-updates（ncu）管理版本升级。
npm install -g npm-check-updates
ncu建议升级顺序：
- 先补丁版本（patch）
- 再次版本（minor）
- 最后主版本（major）
常用命令：
ncu -i --target patch
ncu -i --target minor
ncu -i其中 major 版本务必阅读变更日志与迁移文档。
更新 AstroPaper 模板
如果你基于模板做了定制，升级时要先明确哪些文件不能被覆盖。
通常需要重点保护：
- 内容目录
- src/config.ts
- 自定义样式与资源
- 你新增的组件与页面
用 Git 升级模板（进阶）
如果熟悉冲突处理，可把 astro-paper 仓库作为 remote 拉取更新。
git remote add astro-paper https://github.com/satnaing/astro-paper.git
git checkout -b build/update-astro-paper
git pull astro-paper main若遇到 unrelated histories：
git pull astro-paper main --allow-unrelated-histories随后手动解决冲突并回归测试。
回归检查建议
升级后至少验证以下内容：
- 首页与文章页是否正常渲染
- 搜索、分页、标签页是否可用
- 自定义组件是否仍兼容
- 构建与部署流程是否通过
总结
“先小后大、分层升级、每步可回滚”是最稳的策略。对大多数站点来说，常规依赖更新通常已经够用，不一定每次都要同步模板主线。