GitLab CI/CD执行报错：.gitmodules文件第4行配置错误

• 清理Runner构建目录残留文件
  既然删除本地.gitmodules后仍报错，说明GitLab Runner的构建缓存里还存着旧的错误配置。可以在流水线脚本开头添加清理命令：

  rm -rf /builds/xxxxxxx/software/flask_api_for_mampok/.gitmodules
  rm -rf /builds/xxxxxxx/software/flask_api_for_mampok/.git/modules/*
  git submodule deinit -f .
  

  也可以直接在GitLab项目设置中禁用流水线缓存，再重新触发构建。

• 清理.git/config中的残留配置
  本地和Runner环境的.git/config可能残留了错误的子模块配置项，执行以下命令清理：

  git config --remove-section submodule.metadata-organizer
  git config --remove-section submodule.mampok
  

  若该文件被仓库追踪，可提交修改；否则在流水线脚本中临时执行即可。

• 替换子模块URL为绝对路径
  相对路径在Runner的克隆上下文里可能解析失败，把.gitmodules里的URL换成仓库完整地址：

  [submodule "metadata-organizer"]
      path = metadata-organizer
      url = https://gitlab.example.com/xxxxxxx/metadata-organizer.git
  [submodule "mampok"]
      path = mampok
      url = https://gitlab.example.com/xxxxxxx/mampok.git
  

• 检查文件隐藏字符和编码
  用命令查看文件是否有不可见特殊字符：

  cat -A .gitmodules
  

  若发现^M这类Windows换行符，用工具转换：

  dos2unix .gitmodules
  

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