ESLint与Prettier需协同配置才能实现JS代码统一格式与实时语法检查:安装对应VSCode扩展、本地安装依赖、配置.eslintrc.cjs和.prettierrc文件、设置settings.json启用自动格式化与保存时修复。

如果您在VSCode中进行JavaScript开发,但代码格式不统一、语法错误无法实时提示,则可能是ESLint与Prettier未正确协同工作。以下是实现二者完美结合的具体配置步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装必要扩展
VSCode需通过官方扩展支持ESLint和Prettier的语法检查与自动格式化功能,缺少任一扩展都将导致规则无法生效。
1、打开VSCode,点击左侧活动栏的扩展图标(或按快捷键Ctrl+Shift+X)。
立即学习“Java免费学习笔记(深入)”;
2、在搜索框中依次输入并安装以下两个扩展:ESLint(由Dirk Baeumer维护)与Prettier(by Esben Petersen)。
3、安装完成后,重启VSCode以确保扩展完全加载。
二、初始化项目依赖
ESLint和Prettier需作为开发依赖写入项目本地node_modules,避免全局配置引发团队协作冲突。
1、在项目根目录打开终端,执行命令:npm init -y(若尚未初始化package.json)。
2、执行命令安装ESLint及相关插件:npm install --save-dev eslint eslint-config-standard eslint-plugin-import eslint-plugin-node eslint-plugin-promise eslint-plugin-standard。
3、执行命令安装Prettier及配套ESLint插件:npm install --save-dev prettier eslint-config-prettier eslint-plugin-prettier。
三、配置ESLint规则文件
通过.eslintrc.cjs文件声明校验规则优先级,确保Prettier规则不被ESLint标准规则覆盖。
1、在项目根目录新建文件,命名为.eslintrc.cjs。
2、写入以下内容:
module.exports = {
extends: ['standard', 'plugin:prettier/recommended'],
plugins: ['prettier'],
rules: { 'prettier/prettier': 'error' }
};
四、配置Prettier格式化选项
Prettier需通过独立配置文件定义缩进、引号、行宽等格式偏好,避免与ESLint校验逻辑产生歧义。
1、在项目根目录新建文件,命名为.prettierrc。
2、写入以下内容:
{
"semi": true,
"singleQuote": true,
"tabWidth": 2,
"trailingComma": "es5"
}
五、设置VSCode编辑器行为
VSCode需明确指定默认格式化工具与保存时自动修复行为,否则手动触发格式化将无法联动ESLint修正。
1、按下Cmd+,(macOS)打开设置界面,在右上角点击打开settings.json。
2、在settings.json中添加以下配置项:
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.formatOnSave": true,
"editor.codeActionsOnSave": { "source.fixAll.eslint": true },
"eslint.validate": ["javascript", "javascriptreact"]










