Netlify执行npm run build报错：无法解析路径，本地运行正常

以下是针对本地构建正常、Netlify部署出现Rollup路径无法解析问题的排查和解决步骤：

• 匹配Node版本
  本地与Netlify的Node版本差异可能导致构建逻辑不一致。在项目根目录创建.nvmrc文件，写入本地使用的Node版本号（例如v18.17.0），Netlify会自动读取并使用对应版本构建。

• 校验Vite路径别名配置
  如果vite.config.js中配置了路径别名（如@指代src目录），需确保别名在构建阶段能被Rollup正确识别：

  // vite.config.js
  import { defineConfig } from 'vite'
  import path from 'path'
  
  export default defineConfig({
    resolve: {
      alias: {
        '@': path.resolve(__dirname, './src')
      }
    }
  })
  

  同时在项目根目录的jsconfig.json（或tsconfig.json）中同步配置路径映射：

  {
    "compilerOptions": {
      "baseUrl": ".",
      "paths": {
        "@/*": ["src/*"]
      }
    }
  }
  

• 检查文件名大小写
  本地Windows/macOS系统默认大小写不敏感，但Netlify的Linux环境严格区分大小写。确认所有导入语句中的文件名大小写与实际文件完全一致（比如Header.jsx和header.jsx会被视为不同文件）。

• 核对Netlify构建配置
  进入Netlify项目的「构建与部署」设置页面，确认：

  • 构建命令为npm run build
  • 输出目录与Vite配置的build.outDir一致（Vite默认是dist）

• 清理构建缓存
  在Netlify部署页面找到「清除缓存并重新部署」选项，清理旧缓存后重新构建，避免缓存残留导致的路径问题。

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