将Hugo网站部署至Vercel时的子模块问题求助

以下是几个直接可行的解决方案，按优先级尝试：

1. 开启Vercel的自动子模块拉取功能 #

• 确保本地已将git submodule add生成的.gitmodules文件提交并推送到GitLab仓库，该文件记录了子模块的路径与远程地址。
• 进入Vercel项目的Settings > Git页面，找到Automatically resolve Git submodules选项并开启。由于你的主题是公开仓库，开启后Vercel会自动拉取子模块内容。

2. 自定义Vercel安装命令 #

• 进入Vercel项目的Settings > Build & Development Settings页面，修改Install Command为：

  git submodule update --init --recursive
  

  如果项目需要安装npm/yarn依赖，需合并原有命令，例如：

  npm install && git submodule update --init --recursive
  

  该命令会初始化并拉取所有层级的子模块，确保主题文件被完整获取。

3. 检查GitLab仓库的子模块提交状态 #

• 本地执行git submodule status，确认子模块的路径、远程URL均正确。
• 确保已执行git add .gitmodules themes/fuji并提交推送，Vercel需要读取.gitmodules配置才能识别子模块。

4. 直接嵌入主题代码（备选方案） #

• 若上述方法均无效，可将主题仓库的所有代码复制到本地themes/fuji目录，作为普通文件提交到GitLab仓库。Vercel部署时会直接读取该目录内容，无需拉取子模块。缺点是后续主题更新需手动同步。

内容的提问来源于stack exchange，提问作者dmayilyan