首页/开发/Git 与协作速查/孤儿分支(gh-pages 等独立历史)

孤儿分支(gh-pages 等独立历史)

创建没有父提交的独立分支,用于静态站点发布(gh-pages)或独立制品,与主线历史互不干扰。

Git 与协作速查开发更新于 2026-10-12
创建git checkout --orphan <分支> / git switch --orphan
特点首个提交无父提交,历史独立
典型用途gh-pages 站点、独立制品目录

常用示例

常用示例
git checkout --orphan gh-pages
git rm -rf --cached .   # 清空索引,保留工作区文件
git add .
git commit -m 'docs: init gh-pages'
git push -u origin gh-pages
平台通常允许把该分支设为 Pages 发布源,站点产物不污染主历史。

易错点

  • 忘记清空索引会把当前全部文件带进根提交,历史体积被无谓放大
  • 孤儿分支与主线无共同祖先,跨分支 cherry-pick 会引入全量差异

数据来源与参考

  • GitHub 官方文档:配置发布源(Pages)
  • Git 官方文档:git-checkout(--orphan)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌