如何将Git模板仓库导入全新空仓库并清除历史与分支？

场景说明 #

组织有带历史记录的模板仓库，需创建无任何提交历史、仅保留模板master分支文件结构的全新单分支仓库，不保留模板的分支与历史信息。

步骤1：创建本地空Git仓库 #

• 在本地新建目标仓库文件夹并进入：

  mkdir new-project-repo && cd new-project-repo
  

• 初始化Git仓库（此时仓库为空，无任何提交记录）：

  git init
  

步骤2：导入模板文件（剥离所有历史） #

根据模板仓库的位置，选择以下任一方法：

方法A：模板仓库在本地 #

• 找到本地模板仓库的master分支目录，复制所有文件及隐藏文件（注意：不要复制模板目录下的.git文件夹）
• 将复制的文件粘贴到新仓库目录中
• 在新仓库目录执行提交，完成初始化：

  git add .
  git commit -m "初始化：导入模板基础功能文件"
  

方法B：模板仓库为远程仓库 #

• 在新仓库目录中，拉取远程模板的master分支内容（仅拉取文件，不保留历史）：

  git fetch https://模板仓库地址.git master
  git checkout FETCH_HEAD -- .
  

• 提交初始化内容：

  git add .
  git commit -m "初始化：导入模板基础功能文件"
  

步骤3：关联远程生产仓库（可选） #

如果需要将本地仓库推送到远程生产仓库，执行：

git remote add origin https://生产仓库地址.git
git push -u origin master

关键验证 #

操作完成后，执行git log只会看到这一次初始化提交，git branch仅显示master分支，完全符合无历史、单分支的需求。

内容的提问来源于stack exchange，提问作者jbuddy_13