【踩坑记】Vercel 构建失败：stylus@0.62.0 安装报错及解决方案
💡
原文中文，约2500字，阅读约需6分钟。
📝
内容提要
在 Vercel 部署 Hexo 博客时，遇到 stylus@0.62.0 版本错误，导致构建失败。经排查发现，Vercel 默认镜像源与本地不同，导致依赖解析问题。通过设置环境变量 NPM_CONFIG_REGISTRY 为官方源解决了问题。建议锁定依赖版本、使用官方源并提交 lock 文件，以确保构建环境一致性。
🎯
关键要点
- 在 Vercel 部署 Hexo 博客时遇到 stylus@0.62.0 版本错误，导致构建失败。
- Vercel 默认镜像源与本地不同，导致依赖解析问题。
- 通过设置环境变量 NPM_CONFIG_REGISTRY 为官方源解决了问题。
- 建议锁定依赖版本，确保构建环境一致性。
- 在 package.json 中明确指定 stylus 版本，或使用 Yarn 的 resolutions。
- 始终使用官方源，建议在根目录加入 .npmrc 或 .yarnrc.yml。
- 提交 lock 文件到仓库，以控制依赖树，确保本地与构建环境一致。
- CI/CD 构建需要关注环境一致性、镜像源和依赖锁定。
❓
延伸问答
在 Vercel 部署 Hexo 博客时遇到什么问题？
在 Vercel 部署 Hexo 博客时，遇到 stylus@0.62.0 版本错误，导致构建失败。
为什么 Vercel 构建时会出现 404 错误？
Vercel 默认镜像源与本地不同，导致依赖解析问题，可能是数据同步滞后或元数据签名不匹配。
如何解决 Vercel 的构建失败问题？
可以通过设置环境变量 NPM_CONFIG_REGISTRY 为官方源来解决构建失败问题。
在 package.json 中如何锁定 stylus 的版本？
在 package.json 中可以明确指定 stylus 的版本，例如 'stylus': '0.55.0'，或使用 Yarn 的 resolutions 功能。
为什么建议提交 lock 文件到仓库？
提交 lock 文件可以控制依赖树，确保本地与构建环境一致，避免构建时出现问题。
在 Vercel 项目中如何设置环境变量？
可以在 Vercel 项目的设置中添加环境变量，路径为 Vercel → 项目 → Settings → Environment Variables。
➡️
