背景
- 基于
customize-new分支进行依赖升级,主线main尚未合并。 - 本次通过
pnpm dlx @astrojs/upgrade自动更新 Astro 相关包并安装依赖。
时间写法说明
pubDatetime: 2025-12-16T11:54:00+07:00表示本地时间 11:54,时区是 UTC+7(越南时间)。modDatetime: 2025-12-16T04:54:00Z表示同一时刻的 UTC 时间,用Z表示零时区。- 如果想统一写法,可以都用本地带偏移(
...+07:00),或者都用 UTC(...Z)。
主要改动
- Astro 升级:
astro由 5.12.0 提升至 5.16.5,对应的@astrojs/check、@astrojs/rss、@astrojs/sitemap同步小版本升级。 - 工具链:锁文件更新到新版
vite 6.4.x、yaml 2.7.1等传递依赖;未发现 breaking change 提示。 - 状态检查:升级后工作区干净,仅
package.json与pnpm-lock.yaml有改动;功能运行正常(手动验证)。
部署问题 & 解决
- 问题:Vercel 构建时报 Shiki 类型不兼容(
@shikijs/types3.20.x vs@shikijs/transformers3.7.0),astro check失败。 - 处理:将
@shikijs/transformers升级到^3.20.0,并更新锁文件;本地pnpm run build通过。 - 备注:本地 Windows 环境
cp -r dist/pagefind public/报命令不存在,Vercel(Linux)不受影响。
待办
- 如需部署,先将
customize-new合并回main后推送。 - 如果遇到构建/类型检查异常,可针对单个依赖回滚或补充配置。