该错误仅发生在刚执行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/ 中。
审计 GitHub Actions 工作流文件的密钥泄露风险，例如 pull_request_target 密钥使用、密钥回显命令及未固定版本的 Action 密钥传递。
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，反而绕远路。
