该错误仅发生在刚执行git init但未提交任何内容的空仓库中，因master分支需首次commit后才自动创建，解决方法是先git add .再git commit -m "init"。

git branch 报错 fatal: not a valid object name: 'master'

这个错误只会在一种明确场景下出现：你执行了 git init 初始化了一个空仓库，但还没做任何 commit，就直接运行 git branch dev 或 git checkout -b dev。

Git 的分支本质是指向某个提交（commit）的指针，而 master（或当前默认分支名）必须由**第一次 commit 自动创建**。没提交 → 没对象 → 分支名无效。

• 运行 git status 会显示 “nothing to commit”，且 git branch 输出为空
• 运行 git log 会报同样的 fatal: your current branch 'master' does not have any commits yet 类似错误
• 别急着改配置或删重试，核心动作只有两个：git add + git commit

为什么 git checkout -b dev 也失败

git checkout -b dev 本质是先尝试基于当前分支（默认是 master）创建新分支，再切换过去。如果连 master 都不存在，它根本找不到“基点”，所以同样卡在 not a valid object name。

注意：这不是 Git 版本问题，也不是远程仓库同步问题——这是本地仓库状态不完整导致的。

• 哪怕你刚 git clone 下来，只要远程默认分支不是 master（比如是 main），而你本地又没 fetch 到，git checkout -b dev 也可能因找不到当前分支而报错
• 此时可先用 git symbolic-ref HEAD 看当前 HEAD 指向哪个分支名；若报错，说明 HEAD 是游离态或未初始化
• 最稳妥的兜底操作：先 git add . && git commit -m "init"，再分支

当前目录不是 Git 仓库根目录也会触发同类错误

另一个高频原因：你在克隆后的子目录里执行命令，比如 git clone xxx repo && cd repo/src && git branch dev，但 .git 在 repo/ 下，不在 src/ 中。

Lovefromio Github

使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。

下载

Git 会向上逐级找 .git，但如果路径不对或环境变量 GIT_DIR 被误设，它可能根本找不到仓库，于是把 master 当作一个任意字符串去解析，自然报无效对象名。

• 执行 git rev-parse --git-dir，看是否返回 .git 路径；若报错，说明当前不在有效仓库中
• 执行 pwd 和 ls -a | grep .git 确认位置
• Windows 下尤其注意路径末尾斜杠、空格、中文路径可能导致 Git 解析异常

默认分支名已改为 main，但脚本仍硬写 master

较新版本 Git（2.28+）初始化时默认分支名是 main，不是 master。如果你的自动化脚本或文档里还写 git checkout master，而仓库压根没 master 分支，就会触发该错误。

这不是 bug，是行为变更。Git 不会自动创建 master，除非你显式指定或旧版初始化遗留。

• 查当前默认分支名：git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@'（远程）或 git remote show origin | grep 'HEAD branch'
• 本地初始化后想强制用 master：git init -b master（Git 2.28+ 支持）
• 已有仓库想改默认分支：git branch -M master（前提是已有至少一次 commit）

真正容易被忽略的是：这个错误从不发生在有提交历史的仓库里，只发生在“刚 init 就想分支”的瞬间。修复永远只需两步——加文件、提交。但很多人反复试 git branch -f、git reset 甚至重装 Git，反而绕远路。