0

0

Vite 开发服务器报错:HTML 属性间缺少空格导致解析失败

碧海醫心

碧海醫心

发布时间:2025-12-31 14:04:28

|

784人浏览过

|

来源于php中文网

原创

Vite 开发服务器报错:HTML 属性间缺少空格导致解析失败

vite 启动时因 `index.html` 中 html 标签属性间缺失空格(如 `rel="stylesheet"href="..."`)触发 parse5 解析错误,需严格遵循 html 语法规范修复。

在使用 Vite 搭建的项目(尤其是集成 Tailwind CSS 的前端应用)中,运行 npm run dev 时若遇到如下错误:

Internal server error: Unable to parse HTML; parse5 error code missing-whitespace-between-attributes

这并非 Vite 或 Tailwind 的配置问题,而是 index.html 文件违反了 HTML 标准语法——具体表现为:两个 HTML 属性之间缺少必需的空白字符(空格或换行)

查看你提供的 index.html 片段:

⚠️ 注意:rel="stylesheet" 和 href="..." 之间没有空格,即写成了 "stylesheet"href=,这会导致 HTML 解析器(Vite 内部使用的 parse5)无法正确切分属性,从而抛出 missing-whitespace-between-attributes 错误。

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

HTTPie AI
HTTPie AI

AI API开发工具

下载

✅ 正确写法必须在属性间添加至少一个空格

? 补充说明:HTML 规范要求属性名之间必须由空白符(空格、制表符、换行)分隔。即使浏览器在生产环境可能“宽容”地容错渲染,但 Vite 的开发服务器使用严格的 HTML 解析器(parse5)进行预处理(如注入 HMR 脚本、处理 等),因此会直接报错并中断启动。

? 其他易被忽略的类似错误示例:

  • → 应为
  • → 应为

    ✅ 推荐实践:

    • 编辑器启用 HTML 格式化(如 VS Code 的 Prettier + ESLint with eslint-plugin-html)
    • 在保存时自动修复(配置 "editor.formatOnSave": true)
    • 使用 vite-plugin-checker 或 html-validate 在开发阶段静态检查 HTML 语法

    修复后重新运行 npm run dev,服务即可正常启动。记住:Vite 对 index.html 的语法正确性要求严格,它不仅是入口模板,更是构建流程的解析起点。

相关专题

更多
css
css

css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

500

2023.06.15

css居中
css居中

css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

261

2023.07.27

css如何插入图片
css如何插入图片

cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

731

2023.07.28

css超出显示...
css超出显示...

在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

534

2023.08.01

css字体颜色
css字体颜色

CSS中,字体颜色可以通过属性color来设置,用于控制文本的前景色,字体颜色在网页设计中起到很重要的作用,具有以下表现作用:1、提升可读性;2、强调重点信息;3、营造氛围和美感;4、用于呈现品牌标识或与品牌形象相符的风格。

748

2023.08.10

什么是css
什么是css

CSS是层叠样式表(Cascading Style Sheets)的缩写,是一种用于描述网页(或其他基于 XML 的文档)样式与布局的标记语言,CSS的作用和意义如下:1、分离样式和内容;2、页面加载速度优化;3、实现响应式设计;4、确保整个网站的风格和样式保持统一。

594

2023.08.10

css三角形怎么写
css三角形怎么写

CSS可以通过多种方式实现三角形形状,本专题为大家提供css三角形怎么写的相关教程,大家可以免费体验。

556

2023.08.21

css设置文字颜色
css设置文字颜色

CSS(层叠样式表)可以用于设置文字颜色,这样做有以下好处和优势:1、增加网页的可视化效果;2、突出显示某些重要的信息或关键字;3、增强品牌识别度;4、提高网页的可访问性;5、引起不同的情感共鸣。

387

2023.08.22

小游戏4399大全
小游戏4399大全

4399小游戏免费秒玩大全来了!无需下载、即点即玩,涵盖动作、冒险、益智、射击、体育、双人等全品类热门小游戏。经典如《黄金矿工》《森林冰火人》《狂扁小朋友》一应俱全,每日更新最新H5游戏,支持电脑与手机跨端畅玩。访问4399小游戏中心,重温童年回忆,畅享轻松娱乐时光!官方入口安全绿色,无插件、无广告干扰,打开即玩,快乐秒达!

30

2025.12.31

热门下载

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

精品课程

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

共14课时 | 0.7万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.7万人学习

CSS教程
CSS教程

共754课时 | 17.2万人学习

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

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