GitLab CI/CD子模块切换分支报错：pathspec未匹配Git已知文件

问题根源：CI环境中克隆的子模块默认只会拉取当前关联的分支（这里是main），本地仓库没有同步远程feature_branch的引用，所以执行git checkout时会提示路径不匹配。

解决步骤：

• 进入子模块目录后，先同步远程所有分支信息：

  cd dev1
  git fetch origin
  

• 再切换到目标分支：

  git checkout $feature_branch
  

  若本地从未创建过该分支，也可以直接创建并跟踪远程分支：

  git checkout -b $feature_branch origin/$feature_branch
  

可选优化：如果希望子模块初始化时就同步远程所有分支状态，可以在主仓库的CI脚本里初始化子模块时添加--remote参数：

git submodule update --init --recursive --remote dev1

这样子模块会直接拉取远程仓库的最新分支数据，后续切换分支时无需额外执行fetch。

补充说明：git branch仅显示本地已存在的分支，而git ls-remote是直接查询远程仓库的分支列表，这就是为什么两者输出不一致的原因。在CI这种全新环境下，必须先执行fetch将远程分支信息同步到本地，才能正常切换。

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