0

0

如何为vscode配置前端开发环境_集成ESLint和Prettier的步骤是什么【教程】

紅蓮之龍

紅蓮之龍

发布时间:2026-01-24 12:35:29

|

763人浏览过

|

来源于php中文网

原创

配好 ESLint + Prettier 需装三插件:ESLint(官方)、Prettier(官方)、EditorConfig(推荐);须本地安装 eslint、配置 eslint-config-prettier 并置于 extends 末位;VS Code 中禁用 formatOnSave,启用 codeActionsOnSave 修复 ESLint 问题。

如何为vscode配置前端开发环境_集成eslint和prettier的步骤是什么【教程】

VS Code 里装哪些插件才算配好 ESLint + Prettier

只装插件不配置,等于没装。核心是这三样:ESLint(官方插件)、Prettier(官方插件)、EditorConfig for VS Code(可选但推荐)。注意别装错名字,比如搜 Prettier ESLint 这类拼接名插件,基本是过时或冗余的。

装完后重启 VS Code,否则插件可能不激活。尤其 ESLint 插件依赖项目本地安装的 eslint 包,它不会自动 fallback 到全局版本——这点很多人卡住。

  • 确保项目根目录有 package.json,且已执行 npm install eslint --save-devyarn add eslint -D
  • 如果用 TypeScript,还要加 @typescript-eslint/eslint-plugin@typescript-eslint/parser
  • Prettier 插件本身不带校验能力,它只负责格式化;ESLint 负责代码质量检查,两者职责不能互换

如何让 ESLint 和 Prettier 不打架

默认情况下,Prettier 的格式规则会和 ESLint 的样式类规则(比如 indentquotes)冲突,保存文件时来回覆盖。必须显式禁用 ESLint 中与 Prettier 重叠的规则。

最稳妥的做法是安装 eslint-config-prettier 并在 .eslintrc.js 里关掉所有冲突规则:

立即学习前端免费学习笔记(深入)”;

ModelGate
ModelGate

一站式AI模型管理与调用工具

下载
module.exports = {
  extends: [
    'eslint:recommended',
    'plugin:@typescript-eslint/recommended',
    'prettier' // ← 这行必须放在最后
  ]
};
  • 顺序很重要:prettier 必须是 extends 数组的最后一项,否则会被前面的规则覆盖
  • 不要手动写 rules: { 'no-unused-vars': 'off' } 这类关闭语句,交给 eslint-config-prettier 统一处理更可靠
  • 如果用了 eslint-plugin-prettier(把 Prettier 当作 ESLint 规则运行),需额外加 'plugin:prettier/recommended'extends,但多数现代项目已不推荐这种耦合方式

保存时自动修复,但只修 ESLint 能修的,不是全部格式

VS Code 默认的 editor.codeActionsOnSave 设置容易误解:它触发的是 ESLint 的 fix,不是 Prettier 的格式化。所以如果你关掉了 eslint-config-prettier,或者没配 "eslint.autoFixOnSave": true,保存时什么都不会发生。

推荐在 .vscode/settings.json 中明确声明行为:

{
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  },
  "editor.formatOnSave": false,
  "eslint.validate": ["javascript", "typescript", "vue"]
}
  • "editor.formatOnSave": false 是关键——避免 Prettier 插件和 ESLint 插件同时抢着格式化
  • "eslint.validate" 要列全你实际用的文件类型,比如写 Vue 就得加上 "vue",否则 .vue 文件里的 <script> 块不会被检查
  • 如果真想用 Prettier 格式化注释、HTML 或 CSS,可以单独绑定快捷键(如 Shift+Alt+F),而不是让它参与保存流程

为什么改了配置还是不生效?先查这几个地方

常见失效不是配置写错了,而是 VS Code 没读到正确配置路径,或项目结构干扰了规则加载。

  • 检查 .eslintrc.* 是否在真正的工作区根目录(不是父文件夹),VS Code 只认打开文件夹下的配置
  • 运行 npx eslint . --ext .js,.ts --quiet 看终端是否报错,如果 CLI 能跑通但 VS Code 不行,基本是插件没启用或工作区设置被覆盖
  • 某些 monorepo 工具(如 pnpm workspace、Nx)会让 ESLint 找不到依赖,需要在 .eslintrc.js 里显式指定 parserOptions.project 指向 tsconfig.json
  • Vue 项目中,若用 <script setup>,必须确保 @vue/eslint-config-typescript 版本 ≥ 12.0.0,老版本不识别新语法

最常被忽略的是:ESLint 插件只对打开的文件生效,且依赖当前文件的 language mode(右下角显示 JavaScript / TypeScript / Vue)。如果显示为 Plain Text,再好的配置也没用——先点它,选对语言模式。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

49

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

196

2026.02.25

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

37

2026.03.13

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

457

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

549

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

337

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

531

2023.06.20

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.9万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

CSS教程
CSS教程

共754课时 | 42.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号