github pages 部署出现的问题即解决方法

github 部署网页

• 问题

! Corepack is about to download https://registry.npmjs.org/pnpm/-/pnpm-10.14.0.tgz
 ERR_PNPM_OUTDATED_LOCKFILE  Cannot install with "frozen-lockfile" because pnpm-lock.yaml is not up to date with <ROOT>/package.json

Note that in CI environments this setting is true by default. If you still need to run install in such cases, use "pnpm install --no-frozen-lockfile"

  Failure reason:
  specifiers in the lockfile don't match specifiers in package.json:
* 1 dependencies were added: echarts@^5.6.0

原因是在 github pages 部署时，使用的是 pnpm 作为包管理器，而 pnpm 会在每次安装依赖时更新锁文件（pnpm-lock.yaml），导致锁文件与 package.json 不一致，从而触发上述错误。

• 解决方案

在 CI/CD 等环境中严格使用锁文件（确保依赖版本完全一致），则需要先在本地同步锁文件：

# 先在本地更新锁文件
pnpm install

# 提交更新后的 pnpm-lock.yaml 到版本控制
git add pnpm-lock.yaml
git commit -m "Update pnpm-lock.yaml"

# 然后在目标环境中使用 frozen-lockfile 安装
pnpm install --frozen-lockfile