git checkout --orphan 创建真正空分支，不继承历史且暂存区清空，工作区文件保留；首次提交才生成孤立根提交，需手动 git add && git commit，推送时须 git push origin +。
git checkout --orphan 创建的是真·空分支
执行 git checkout --orphan <branch-name></branch-name> 后，新分支确实不继承任何提交历史，工作区文件也保留（但暂存区清空），这是 Git 唯一原生支持“从零开始建分支”的方式。它不是“删掉历史”，而是让新分支的 HEAD 指向一个尚未存在的提交，后续第一次 git commit 才真正生成孤立根提交。
常见错误现象：git checkout --orphan new-branch 之后运行 git status 显示“all files are untracked”——这不是出错，是预期行为；此时 git add . && git commit 才真正创建首个提交。
- 必须在
git checkout --orphan后立刻git add+git commit，否则切换回其他分支再回来，可能误触已暂存的旧文件 - 如果想清空工作区文件（比如只留 README.md），得手动
git clean -fdx && git reset --hard（慎用！先确认没未提交的重要修改） -
--orphan在 Git 2.17+ 支持，旧版本会报错unknown switch `orphan'
git switch --orphan 是更安全的替代写法
git switch 是 Git 2.23+ 引入的专用分支操作命令，语义比 git checkout 更清晰。用 git switch --orphan <branch-name></branch-name> 效果相同，但不会意外触发 checkout 的文件覆盖逻辑（比如不会因为路径名匹配而覆盖工作区文件）。
使用场景：CI 脚本中自动创建文档分支（如 gh-pages）、初始化纯配置分支、或为第三方库打补丁时需要完全干净的起点。
-
git switch --orphan不会自动清理工作区，和checkout --orphan一样需手动处理文件 - 如果当前有未提交变更，
git switch --orphan会直接失败并提示error: Your local changes would be overwritten，比checkout更严格 - 不支持
-c（create）缩写，必须写全--orphan
push 空分支到远程要加 + 号强制推送
本地空分支首次推送到远程时，Git 默认拒绝，因为远程没有对应引用，且该分支无共同祖先。必须用 git push origin +<branch-name></branch-name>（带 + 表示强制更新引用）。
GitHub 智能代码审查与 CI/CD 自动化工作流。收到 PR 或代码提交时，自动进行 AI 代码审查（bug/安全/逻辑），并根据审查结果智能生成或推荐 GitHub Actions 工作流。触发词：代码审查、review PR、生成 CI/CD、GitHub Actions。
错误信息典型是：! [rejected] new-branch -> new-branch (non-fast-forward) —— 这不是权限问题，是 Git 的保护机制。
- 仅首次推送需要
+，后续git push恢复正常 - 如果远程已有同名分支（哪怕空），先用
git push origin :<branch-name></branch-name>删除它（冒号前有空格） - 某些托管平台（如 GitHub Pages）要求分支必须存在且含
index.html才激活服务，空分支推上去后仍需至少一次有效提交
别用 git init + git remote add 模拟空分支
有人试图新建空目录、git init、git remote add、再 git push，这会产生一个独立仓库，与原仓库无关联，后续无法拉取主干更新，也不被 Git 认为是“同一项目下的分支”。
本质区别：真正的空分支仍属于原仓库的 refs/heads/ 命名空间，能参与 git fetch、git merge-base 等所有分支间操作；而独立仓库只是另一个 Git 项目。
- 用
git ls-remote origin可验证：正确空分支会在输出中显示其 commit hash；模拟方式则完全查不到 - CI 中若需隔离构建产物，应使用
--orphan+git rm -rf .清理，而不是另起仓库 - GitHub/GitLab 的 branch protection 规则对
--orphan创建的分支依然生效，对独立仓库无效
最容易被忽略的是：空分支的“空”只针对提交历史，不自动清理工作区文件。很多人卡在 git status 显示一堆 modified 却不知道该不该 git add，其实得先想清楚——这个分支到底要放什么内容，再决定是保留、删减还是全部清空。
