部署至Netlify遇Module not found错误，本地正常该如何排查？

以下是几种可能的原因及解决办法：

• Netlify构建缓存残留
  Netlify会缓存之前的构建产物，旧的导入路径可能还留在缓存里。解决：进入Netlify站点后台，依次点击「站点设置」→「构建和部署」→「构建缓存」，选择「清除缓存并重新构建」，触发一次全新构建。

• 文件名大小写敏感性问题
  本地系统（Windows/macOS默认不区分文件名大小写）能正常运行，但Netlify使用的Linux服务器严格区分大小写。即使你修改了文件名，可能代码中还有未更新的小写引用。解决：全局搜索整个代码库（包括所有.js/.jsx/.ts/.tsx文件），找出所有./components/Scrolltotop的导入语句，全部替换为./components/ScrollToTop；同时检查组件调用时的名称是否一致。

• Git未追踪文件名大小写变更
  如果你是在不区分大小写的系统上修改的文件名，Git可能不会自动识别大小写变化，导致远程仓库的文件名实际没更新。解决：在本地执行以下命令更新Git缓存并提交：

  git rm --cached src/components/Scrolltotop.js
  git add src/components/ScrollToTop.js
  git commit -m "Fix filename case sensitivity"
  git push
  

  之后再触发Netlify的重新构建。

• 本地打包缓存与部署环境不一致
  本地的打包工具（如Webpack、Vite）缓存可能掩盖了问题，但部署时没有这个缓存。解决：可以在Netlify的构建命令中添加清除本地缓存的步骤，比如对于React项目，将构建命令改为：

  npm run clean && npm run build
  

  （前提是你的package.json中配置了clean脚本，比如"clean": "rimraf build"）

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