迁移GitHub仓库到新电脑后启动React项目报3个Unexpected token '<'错误

这个报错本质是浏览器请求JS静态资源时，服务端返回了HTML内容（通常是404页的起始<标签），浏览器按JS语法解析失败触发。

常见触发场景（Git仓库迁移后） #

• 项目publicPath配置和新设备的运行环境不匹配，devServer或打包后的资源请求路径错误，服务端 fallback 到index.html返回HTML内容
• 跨设备迁移后node_modules缓存损坏，或者克隆仓库后未重新安装依赖
• Git克隆过程中文件缺失，或者gitignore规则异常导致必要的资源文件未被拉取到新设备

对应解决步骤 #

1. 核对React项目webpack/vite配置中的publicPath字段，和本地开发的服务路径、代理规则保持一致
2. 清空旧的依赖缓存重新安装：

# 如果你使用npm
rm -rf node_modules package-lock.json && npm install
# 如果你使用yarn
rm -rf node_modules yarn.lock && yarn install
# 如果你使用pnpm
rm -rf node_modules pnpm-lock.yaml && pnpm install

3. 若以上步骤无效，可直接将原设备中的完整仓库打包为ZIP文件传输到新设备，解压后重新执行依赖安装再启动项目即可解决

原始报错信息 #

Uncaught SyntaxError: Unexpected token '<' bundle.js:1 
Uncaught SyntaxError: Unexpected token '<' vendors~main.chunk.js:1 
Uncaught SyntaxError: Unexpected token '<' main.chunk.js:1  

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