React Web App 推送新仓库后本地无法运行、GitHub Pages部署失败求助

本地项目无法运行修复 #

• 首先检查项目根目录是否存在完整的node_modules文件夹，若文件夹缺失/为空，在根目录终端执行npm install重新安装所有依赖，依赖安装完成后执行原项目启动命令（通常为npm run dev或npm start）即可恢复运行。
• 若重装依赖后仍无法运行，可删除node_modules文件夹与锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml）后，再次执行npm install重新安装即可。

Git推送被拒修复 #

该问题是因为你在将node_modules纳入Git追踪后才添加.gitignore配置，Git依然会尝试上传已追踪的依赖文件夹，按以下步骤操作即可解决：

• 确认.gitignore文件存放在项目根目录，且文件内已添加node_modules/配置项。
• 在项目根目录终端执行命令，将已被Git追踪的node_modules从缓存中移除（不会删除本地依赖文件）：

git rm -r --cached node_modules

• 重新提交变更：

git add .
git commit -m "移除Git追踪的node_modules，更新.gitignore配置"

• 重新执行推送操作即可，不会再触发文件数量超限报错。

后续GitHub Pages部署提示 #

• 部署到GitHub Pages不需要手动上传node_modules文件夹，配置好Pages的构建工作流后，平台会自动安装依赖、打包项目完成部署，你提前配置好的域名可以在Pages设置页直接绑定使用。

相关附件 #

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