React项目执行npm run build后，如何避免build目录下的.git文件夹消失？

React项目执行npm run build时，默认会完全清空build目录再重新生成编译产物，这就是你放在build里的.git文件夹消失的原因。下面提供几种可行的解决办法：

方案1：修改build脚本，保留/恢复.git目录 #

如果使用create-react-app这类默认会清空build的工具，可以通过自定义脚本跳过删除.git目录，或者提前备份、事后恢复：

1. 先把build目录下的.git备份到项目根目录：

   mv build/.git .build-git
   

2. 修改package.json中的scripts，调整build流程：

   "scripts": {
     "build": "npm run build:clean && npm run build:compile && npm run build:restore-git",
     "build:clean": "rm -rf build/*",
     "build:compile": "react-scripts build",
     "build:restore-git": "if [ -d .build-git ]; then mv .build-git build/.git; fi"
   }
   

   这里用rm -rf build/*替代直接删除整个build目录，只会删除目录内的文件（不包含隐藏的.git），编译完成后再把备份的.git移回build目录。

   注意：Windows系统需要把rm -rf build/*替换为del /s /q build\*，或者使用cross-env实现跨系统兼容。

方案2：将build仓库放在项目外部，同步产物 #

把存放build产物的Git仓库独立到项目目录外，每次编译后同步文件过去，避免build目录清空影响.git：

1. 在项目同级目录创建并初始化独立仓库：

   mkdir ../react-build-repo && cd ../react-build-repo && git init
   

2. 在项目的package.json中添加同步脚本：

   "scripts": {
     "build": "react-scripts build",
     "build:deploy": "npm run build && cp -r build/* ../react-build-repo/ && cd ../react-build-repo && git add . && git commit -m 'Update build artifacts' && git push"
   }
   

   执行npm run build:deploy即可完成编译、同步、提交推送的全流程，外部仓库的.git不会受到build目录清空的影响。

方案3：使用Git Worktree（推荐） #

利用Git的worktree功能，将build产物作为主仓库的一个独立分支来管理，无需额外创建仓库：

1. 在React项目根仓库创建专门存放build的分支（比如build-branch）：

   # 创建无父提交的孤儿分支
   git checkout --orphan build-branch
   # 清空分支内容
   git rm -rf .
   # 添加初始文件并提交
   echo "Build artifacts repository" > README.md
   git add README.md
   git commit -m "Initial build branch setup"
   # 切回主分支
   git checkout main
   

2. 将build-branch分支检出到build目录：

   git worktree add build build-branch
   

   此时build目录下的.git是一个指向主仓库git目录的链接文件，而非文件夹。
3. 修改package.json的build脚本，避免删除这个.git链接：

   "scripts": {
     "build": "npm run build:prep && react-scripts build && npm run build:post",
     "build:prep": "if [ -f build/.git ]; then mv build/.git .temp-git; fi",
     "build:post": "if [ -f .temp-git ]; then mv .temp-git build/.git; fi && git -C build add . && git -C build commit -m 'Update build artifacts'"
   }
   

   编译前先把build目录的.git临时移到根目录，编译完成后移回，再提交到build-branch分支。

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