git checkout --orphan 创建的分支没有历史，因为它不继承任何父提交，仅创建一个指向空提交链的分支指针；工作目录文件保留是因该命令只重置 HEAD 和提交历史，不修改工作区和暂存区，需手动 git rm -rf . 清空或 git add -A 保留文件后提交。
Git孤立分支不是“空分支”，而是没有父提交的分支——它自带文件，但不带历史。想用它做干净起始点，必须手动清空再提交，否则你看到的只是原分支的文件快照。
git checkout --orphan 创建后为什么文件还在？
因为 git checkout --orphan 只重置 HEAD 和提交链，不碰工作区和暂存区。它保留当前分支所有已跟踪文件的状态，就像复制了一份“未提交的草稿”。这是最容易误解的一点：你以为进了新世界，其实只是换了个分支名继续编辑旧文档。
- 执行
git checkout --orphan new-branch后，git status会显示所有文件为“已暂存”（staged） -
git log返回空，但ls看到的代码一个没少 - 如果不手动
git rm -rf .，直接git commit，就等于把原项目所有文件塞进一个“无历史”的初始提交里——这不是清空，是伪装清空
什么时候该用 git rm -rf .，什么时候不该？
取决于你要的是“真正空白”还是“保留文件但重置历史”。前者用于 gh-pages、静态资源分支；后者用于重构主干、剥离子模块。
- 要纯空白分支（比如放文档、图片、CI 构建产物）：
git rm -rf .→ 添加必要文件（如README.md）→git add .→git commit - 要保留全部代码但丢掉历史（如创业公司清理 2000+ 混乱提交）：跳过
git rm -rf .→ 直接git add -A→git commit -m"init: clean slate" - 误删了未跟踪文件（如
node_modules或本地配置）？git rm -rf .不会影响它们，但后续git add .也不会自动加回来——得自己补
push 到远程前必须注意的三件事
孤立分支第一次 push 不能用 git push -u origin new-branch 简写，Git 会报错 src refspec new-branch does not match any，因为远程尚无该分支引用。
- 必须显式指定引用：
git push origin new-branch（不是git push origin new-branch:new-branch，后者冗余） - 如果远程已有同名分支（比如之前失败过），先运行
git push origin --delete new-branch清理 - GitLab / GitHub 页面类分支（如
gh-pages、gitlab-pages）默认不触发 CI，需检查项目设置里的 Pages 配置是否指向正确分支
git switch --orphan 在新版本中的行为差异
git switch --orphan 是 git checkout --orphan 的现代替代，但 Git 2.23+ 才支持。两者创建效果一致，区别在于语义更清晰，且 git switch 本身不处理文件操作——它只管分支切换。
- 如果你用的是 Git < 2.23，坚持用
git checkout --orphan -
git switch --orphan new-branch后，仍需手动git rm -rf .或git add -A，不存在“自动清空”或“自动保留”的隐式行为 - 某些 IDE（如 VS Code）的 Git 图形界面不识别
--orphan，点击“新建分支”仍走git checkout -b流程——务必切回终端执行
最常被忽略的细节：孤儿分支一旦提交，就再也无法通过 git merge 或 git rebase 与原历史建立连接。它真的一刀两断——不是隐藏，是物理隔离。用之前想清楚，你到底是要“搬家”，还是“拆家”。
