加入Github仓库后无法启动应用，遇JS bundle损坏相关报错求解决

第一步：全量清理本地构建缓存 #

• 删除项目依赖目录和锁文件：

  rm -rf node_modules package-lock.json yarn.lock pnpm-lock.yaml
  

• 重新安装依赖，使用项目对应的包管理器即可：

  npm install
  # 或者 yarn install / pnpm install
  

• 清理框架自带缓存：
  React Native项目执行：

  npx react-native start --reset-cache
  

  React/Vue等前端Web项目执行：

  # webpack项目
  rm -rf dist build .webpack
  # vite项目
  rm -rf node_modules/.vite
  

第二步：校验bundle构建过程 #

• 手动执行项目的构建命令，逐行查看构建日志是否有error、warn提示，绝大多数bundle损坏问题都是构建过程中某个依赖或者业务代码编译失败导致，日志会明确给出错误文件路径和原因
• 构建完成后校验产物完整性：检查构建输出目录下的JS bundle文件是否存在、文件大小是否符合常规（正常不会出现仅几KB的空文件）

第三步：排除本地环境差异问题 #

• 核对本地Node版本和项目README中指定的Node版本是否一致，大版本差异（比如Node14和Node18）极易导致依赖编译异常，最终触发bundle损坏
• 检查是否有全局依赖和项目依赖冲突，比如全局安装的webpack版本与项目指定版本不一致，优先使用项目内的命令执行构建，比如用npx webpack代替直接调用全局webpack命令

第四步：兜底验证 #

• 拉取一份全新的仓库副本，按照README步骤从头执行安装、构建、启动流程，排除当前本地仓库存在未提交的误改内容的可能性
• 如果仍然报错，可以补充完整的构建日志信息，能更快定位具体问题点

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