Next.js v12导入大小写不敏感引发问题，求解决方案

一、临时忽略大小写（应急用，不推荐长期使用） #

Linux文件系统严格区分大小写，而Windows默认不敏感，这是跨环境报错的核心原因。如果只是临时应急，可以修改Next.js的Webpack配置绕过问题：

在项目根目录的next.config.js中添加以下配置：

module.exports = {
  webpack: (config) => {
    // 开启导入路径大小写忽略
    config.resolve.ignoreCase = true;
    return config;
  },
};

注意：这个方法只是暂时掩盖问题，长期会导致团队文件大小写不统一，后续切换环境仍会报错，建议优先用批量修正方案。

二、批量修正所有大小写问题（推荐） #

1. 用ESLint自动修复 #

借助ESLint插件可以批量修正导入语句和文件名的大小写不匹配：

• 安装依赖：

  npm install eslint-plugin-import eslint-plugin-unicorn --save-dev
  

• 修改项目的.eslintrc.json（或对应ESLint配置文件）：

  {
    "plugins": ["import", "unicorn"],
    "rules": {
      // 强制文件名符合驼峰/大驼峰命名
      "unicorn/filename-case": [
        "error",
        {
          "cases": {
            "camelCase": true,
            "pascalCase": true
          }
        }
      ],
      // 检测导入路径是否存在（识别大小写）
      "import/no-unresolved": "error",
      "import/namespace": "error"
    }
  }
  

• 运行自动修复命令：

  npx eslint --fix .
  

  该命令会自动修正所有符合规则的导入语句和文件名大小写问题。

2. Neovim中配置自动保存修复 #

在Neovim里可以配置保存文件时自动修复，借助LSP服务实现：
比如用lspconfig配置ESLint，添加自动保存钩子：

require('lspconfig').eslint.setup({
  on_attach = function(client, bufnr)
    -- 保存前自动执行ESLint修复
    vim.api.nvim_create_autocmd("BufWritePre", {
      buffer = bufnr,
      command = "EslintFixAll",
    })
  end,
})

这样每次保存文件时，Neovim会自动修复当前文件的大小写导入问题。

补充说明 #

Windows文件系统默认不区分大小写，所以之前的代码在Windows下能正常运行，但WSL的Ubuntu基于Linux内核，严格区分大小写，因此出现这类错误。批量修正后能保证代码跨环境一致性，也符合团队协作规范。

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