深入解析antfu/eslint-config中VSCode的ESLint错误提示问题

在antfu/eslint-config项目中，一个常见的问题是用户在使用VSCode时发现ESLint不会显示格式相关的错误提示。这个现象其实是由项目推荐的VSCode配置设计导致的，而非真正的功能缺陷。

问题本质

项目默认配置中，通过.vscode/settings.json文件对ESLint进行了特殊设置，目的是为了优化开发体验。具体来说，它将所有可自动修复的样式规则(如缩进、空格、引号等)的严重性设置为"off"，同时启用了保存时自动修复功能。

这种设计理念来源于现代前端开发的实践：

1. 开发者不需要被可自动修复的格式问题干扰注意力
2. 保存文件时自动应用所有格式化修复
3. 保持代码风格一致性而不需要手动干预

配置详解

项目推荐的VSCode配置包含几个关键部分：

1. 禁用Prettier：完全使用ESLint进行格式化
2. 保存时自动修复：通过editor.codeActionsOnSave设置
3. 静默样式规则：通过eslint.rules.customizations将各类样式规则的显示关闭
4. 广泛的语言支持：eslint.validate包含了几乎所有常见的前端文件类型

解决方案

如果用户确实希望在编辑时看到这些样式错误提示，可以修改VSCode配置：

1. 删除或注释掉eslint.rules.customizations部分
2. 或者只保留需要的规则静默，移除不需要的部分
3. 也可以调整severity从"off"改为"warn"或"error"

最佳实践建议

对于团队项目，推荐保持原配置，因为：

• 自动修复能保证代码风格统一
• 减少无关的视觉干扰
• 提高开发效率

对于个人项目或学习目的，可以根据需要调整配置来显示更多提示信息，帮助理解ESLint规则。

理解这种设计选择背后的理念，能帮助开发者更好地使用和配置antfu/eslint-config，打造更高效的开发工作流。