create-react-app生成的React应用迁移后报错，如何安全移动

直接剪切CRA项目后启动报错找不到原路径，和你在业务代码里使用相对路径的配置完全无关，核心报错来源是两类绑定了旧绝对路径的本地文件：

• node_modules 目录下的原生编译依赖、npm 生成的启动脚本，硬编码了项目第一次创建时的绝对路径，这类文件不会跟着文件夹的剪切自动适配新位置
• 开发流程生成的本地缓存（比如react-scripts的构建缓存、webpack的持久化缓存），启动时会优先读取上次缓存的旧路径配置，找不到就会直接报错

可直接落地的迁移操作流程 #

• 将项目所有文件从原目录完整剪切/复制到目标新路径
• 删除新路径项目下所有和本地环境绑定的生成文件：
  • 整个 node_modules 文件夹
  • 根目录下的 .cache 隐藏缓存文件夹
  • （可选但推荐）package-lock.json 文件，避免锁文件中残留的路径配置引发依赖安装异常
• 在新路径的项目根目录下执行 npm install，重新拉取安装所有依赖，生成适配新路径的依赖配置
• 依赖安装完成后执行 npm start，即可正常启动项目，不会再出现原路径找不到的报错

常见踩坑提醒 #

• 不要携带 node_modules 文件夹跨目录、跨盘符迁移，哪怕所有业务代码都用相对路径配置，node_modules 内部的硬编码路径随时可能引发热更新失效、依赖调用报错等难以排查的问题
• 如果重新安装依赖后仍报旧路径错误，可先执行 npm cache clean --force 清空本地npm全局缓存，再重新执行依赖安装
• 不要通过创建软链（符号链接）的方式绑定原项目路径跳过重新安装的步骤，这种方式容易引发本地服务权限异常、文件监听失效等问题

内容的提问来源于stack exchange，提问作者T.M15