排除Prettier与Linter配置冲突以保障团队HTML代码质量

P粉328763957

P粉328763957

2026-07-06

745人浏览

原创

prettier和eslint在html上冲突是因为eslint插件(如eslint-plugin-html/vue)尝试格式化html,而prettier按自身规则重排属性、缩进等,导致保存时循环修改;解决方法是禁用eslint的html格式规则,仅用prettier处理html格式,并通过eslint-plugin-prettier统一协调,同时确保vscode配置不并行触发两者,且版本兼容。

排除prettier与linter配置冲突以保障团队html代码质量

为什么HTML里Prettier和ESLint会互相改来改去

因为 ESLint 默认不处理 HTML,但很多人用 eslint-plugin-htmleslint-plugin-vue 把 HTML 片段塞进 JS 文件里检查;而 Prettier 的 html 解析器又会按自己规则重排缩进、属性顺序、引号类型。两者没对齐时,比如 ESLint 要求 class 属性在前,Prettier 却按字母序排,保存一次就触发一次“格式→报错→再格式”的死循环。

只让Prettier管HTML格式,ESLint专注逻辑检查

核心是切断 ESLint 对 HTML 格式类规则的干预,把风格控制权全交给 Prettier:

使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件
使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件

如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Andr​​oid友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Andr​​oid应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更

下载
  • 卸载或禁用任何试图格式化 HTML 的 ESLint 插件,比如 eslint-plugin-html(除非你真需要它检查内联 script/style 里的 JS/CSS)
  • .eslintrc.jsextends 里去掉所有含 html 字样的 preset,只保留 eslint:recommendedplugin:prettier/recommended
  • 确保 eslint-plugin-prettier 已安装且启用,这样 Prettier 的 HTML 格式结果会被当作 ESLint 的“正确答案”,而不是冲突源
  • .prettierrc 中显式声明 HTML 相关配置,例如:
    { "htmlWhitespaceSensitivity": "css", "endOfLine": "lf" }

VSCode 里别让两个工具同时保存时动手脚

VSCode 默认可能同时启用 ESLint 自动修复和 Prettier 格式化,这是 HTML 冲突最常爆发的地方:

  • 删掉 "editor.formatOnSave": true 这一行——它会让 Prettier 独立跑一遍,绕过 ESLint 的协调机制
  • 只保留 "editor.codeActionsOnSave": { "source.fixAll.eslint": true },确保所有修复(包括 HTML 格式)都经由 ESLint → eslint-plugin-prettier → Prettier 这条链路执行
  • 确认 VSCode 的默认格式化工具设为 esbenp.prettier-vscode,但实际不启用它直接格式化,仅作为底层引擎被 ESLint 调用

Vue/Svelte/React 中内联HTML的特殊处理

框架模板里的 HTML 更容易出问题,因为解析器不同:

  • Vue 项目必须用 eslint-plugin-vue,但它自带的格式规则(如 vue/html-closing-bracket-newline)会和 Prettier 冲突,解决方案是:在 .eslintrc.jsrules 中显式关闭这些规则,例如:"vue/html-closing-bracket-newline": "off"
  • Svelte 项目推荐用 svelte3 parser 配合 prettier-plugin-svelte,并在 .prettierrc 中加 "plugins": ["prettier-plugin-svelte"],否则 Prettier 会把 Svelte 语法当普通 HTML 错误解析
  • React 的 JSX 本身被 Prettier 原生支持,但若用了 eslint-plugin-reactreact/jsx-props-no-spreading 等规则,它们不涉及格式,可放心共存;真正要关的是 react/jsx-indent 这类缩进规则
真正容易被忽略的点是:Prettier 的 HTML 解析器版本必须和 eslint-plugin-prettier 兼容。比如 Prettier 3.2+ 默认用新 HTML 解析器,但旧版 eslint-plugin-prettier@4.x 可能不识别,导致 prettier/prettier 规则失效——此时 ESLint 就不再约束 HTML 格式,冲突看似消失,实则失控。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

html

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2551

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

1657

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

1414

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

1341

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

3685

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

1367

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

1124

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

1060

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

988

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 156人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 5万人学习