解决antfu/eslint-config在Windows WSL中ESLint启动失败问题

问题现象

在使用antfu/eslint-config配置项目时，部分Windows用户在WSL环境下会遇到ESLint启动失败的问题。具体表现为在代码保存时，ESLint服务无法正常启动，控制台会显示如下错误信息：

Named export 'minimatch' not found. The requested module 'minimatch' is a CommonJS module...

问题根源分析

这个问题的本质是Node.js模块系统在WSL环境下的兼容性问题。具体来说：

1. 模块导出方式冲突：错误信息表明minimatch模块是一个CommonJS模块，而ESLint尝试使用ES模块的命名导入方式(import { minimatch } from 'minimatch')来加载它

2. WSL版本差异：在较旧版本的WSL或Ubuntu子系统中，Node.js对ES模块和CommonJS模块的互操作性处理可能存在差异

3. 环境隔离：Windows与WSL环境之间的文件系统交互可能导致模块解析出现意外行为

解决方案

方法一：升级WSL和Ubuntu子系统

1. 确保使用最新版本的WSL
2. 将Ubuntu子系统升级到较新版本(如Ubuntu 24.04 LTS)
3. 更新Node.js到最新LTS版本

方法二：修改模块导入方式

如果暂时无法升级环境，可以临时修改相关代码，使用兼容性更好的导入方式：

// 修改前
import { minimatch } from 'minimatch'

// 修改后
import pkg from 'minimatch'
const { minimatch } = pkg

方法三：检查项目依赖

1. 确保项目中使用的eslint和所有相关插件都是最新版本
2. 清理node_modules并重新安装依赖
3. 检查是否有冲突的依赖版本

预防措施

1. 统一开发环境：团队内部尽量保持一致的开发环境配置
2. 版本锁定：使用package-lock.json或pnpm-lock.yaml锁定依赖版本
3. CI/CD验证：在持续集成流程中加入Windows/WSL环境的测试

总结

antfu/eslint-config作为流行的ESLint配置方案，在不同环境下可能会遇到模块系统兼容性问题。通过升级WSL环境或调整模块导入方式，可以有效解决这类问题。对于团队项目，建议建立统一的环境规范，减少因环境差异导致的问题。