You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何配置Vercel克隆项目时自动拉取Git子模块?

Vercel 部署 Git 子模块形式 Hexo 主题的配置方法

Hexo 采用 Git 子模块管理主题时,Vercel 默认克隆流程不会自动拉取子模块内容,会直接导致构建阶段因主题文件缺失失败。

操作步骤

  • 登录 Vercel 控制台,进入对应博客项目的设置页,找到 Settings > General > Build & Development Settings 配置区
  • 定位到 Install Command 配置项,选择覆写默认命令,填入以下组合指令:
git submodule init && git submodule update && npm install

若你使用 yarn/pnpm 作为包管理器,将命令末尾的 npm install 替换为对应包管理器的依赖安装命令即可,pnpm 用户可替换为 pnpm install

  • 保存配置后重新触发部署即可。构建时会先完成子模块初始化、主题文件拉取,再执行依赖安装与 Hexo 构建流程。

补充说明:如果使用的子模块属于私有仓库,需要提前在 Vercel 项目环境变量中配置该仓库的读取权限凭据,否则会触发子模块拉取权限错误。
Vercel 子模块缺失部署报错截图

内容的提问来源于stack exchange,提问作者Mizore

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 09:51:45