如何配置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 项目环境变量中配置该仓库的读取权限凭据,否则会触发子模块拉取权限错误。
内容的提问来源于stack exchange,提问作者Mizore
相关产品推荐
相关产品推荐


