使用git init创建仓库时HEAD..origin/master参数歧义错误的解决咨询

问题背景 #

使用git init创建本地仓库，默认分支为main，但出现以下错误：

fatal: ambiguous argument 'HEAD..origin/master': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

本地仅存在main分支，执行git branch -a输出：

* main

该错误源于Shell提示符的Git信息展示功能默认假设master分支存在，需修改提示符配置。

具体解决步骤（针对MacOS 12.4 + zsh + iTerm2） #

情况1：使用Oh My Zsh的git插件 #

1. 打开zsh配置文件：

   open ~/.zshrc
   

2. 找到Git提示符相关配置，若使用默认主题（如robbyrussell），可在.zshrc末尾添加自定义的git_prompt_info函数，替换硬编码的分支逻辑：

   git_prompt_info() {
     local ref
     if [[ "$(command git config --get oh-my-zsh.hide-status 2>/dev/null)" != "1" ]]; then
       ref=$(command git symbolic-ref HEAD 2>/dev/null) || \
       ref=$(command git rev-parse --short HEAD 2>/dev/null) || return 0
       echo "$ZSH_THEME_GIT_PROMPT_PREFIX${ref#refs/heads/}$(parse_git_dirty)$ZSH_THEME_GIT_PROMPT_SUFFIX"
     fi
   }
   

   也可更换为支持动态分支的主题（如agnoster），避免硬编码master的逻辑。
3. 保存配置后重新加载zsh：

   source ~/.zshrc
   

情况2：自定义zsh提示符配置 #

1. 检查.zshrc或.zprofile中是否有包含origin/master的自定义Git分支检测代码。
2. 将硬编码的master替换为动态获取的分支，或移除不必要的远程分支对比逻辑：
   示例：先获取远程默认分支再使用

   local remote_default_branch=$(command git remote show origin | grep 'HEAD branch' | awk '{print $NF}')
   # 后续用$remote_default_branch替代原代码中的master
   

3. 保存后重新加载配置：

   source ~/.zshrc
   

情况3：使用第三方提示符工具（如powerlevel10k） #

1. 打开p10k配置文件：

   open ~/.p10k.zsh
   

2. 搜索包含master的配置项（如DEFAULT_GIT_REMOTE_BRANCH），修改为支持动态分支或设置为main。
3. 重新加载配置：

   source ~/.p10k.zsh
   

内容的提问来源于stack exchange，提问作者T. Walter