执行npm run build时Rollup解析导入失败问题求助

• 检查index.html的资源引用路径
  确认index.html中<script>标签里的/assets/index-c42d0bed.js路径是否匹配Vite的构建输出规则：

  • 若配置了vite.config.js中的base参数，资源路径需要带上对应的前缀；
  • 手动删除项目根目录的dist文件夹后，重新执行npm run build，规避旧缓存文件的干扰。

• 核查Vite构建配置
  打开vite.config.js/vite.config.ts，重点检查：

  • build.rollupOptions是否存在自定义的输入/输出规则，是否误将目标JS文件排除在打包范围外；
  • 是否有第三方Vite/Rollup插件修改了资源输出路径或文件名，导致生成的文件与index.html中的引用不匹配。

• 排查静态资源的存放与引用逻辑

  • 确认项目中是否存在硬编码index-c42d0bed.js文件名的情况（构建时文件名哈希会动态生成，硬编码必然导致路径不匹配）；
  • 若该文件放在public目录下，检查目录结构：如果直接放在public根目录，引用路径应为/index-c42d0bed.js，而非/assets/...；若放在public/assets下，则路径正确，但需确认构建后dist目录中是否存在该文件。

• 进阶清理与重装操作
  除常规重装外，执行以下步骤彻底清理缓存：

  • 清理包管理器全局缓存：npm cache clean --force（npm）/ pnpm store prune（pnpm）/ yarn cache clean（yarn）；
  • 删除项目的node_modules、package-lock.json（或对应锁文件），重新执行npm install后再尝试构建。

• 查看详细构建日志定位问题
  执行带调试参数的构建命令：npm run build -- --debug，从输出的详细Rollup日志中，定位该JS文件在打包流程中是被忽略、路径配置错误还是生成环节出现异常。

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