You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

HTML解析失败:parse5错误invalid-first-character-of-tag-name,Vite配置无效求助

解决parse5错误:invalid-first-character-of-tag-name(HTML解析失败)

从错误信息能看到,你的index.html文件第一行开头存在隐藏的UTF-8 BOM字节标记(显示为��),这导致parse5解析器无法识别合法的HTML标签起始字符,从而抛出invalid-first-character-of-tag-name错误。

解决方案:

  • 移除文件的UTF-8 BOM标记

    1. 用支持编码设置的文本编辑器打开index.html(推荐VS Code、Notepad++)
    2. VS Code操作:点击右下角的编码标识(如「UTF-8」),选择「通过编码保存」,然后选择「UTF-8」(注意不要选「UTF-8 with BOM」)
    3. Notepad++操作:顶部菜单栏选择「编码」→「UTF-8 无BOM」,然后保存文件
  • 确认文件内容
    保存后检查文件第一行,确保开头直接是<!DOCTYPE html>,没有任何前置的奇怪字符。

  • 重启Vite服务
    关闭当前运行的Vite开发服务器,重新执行npm run dev启动服务,问题即可解决。

补充说明:

你之前修改Vite配置文件无效,是因为这个错误的根源是HTML文件本身的编码问题,和Vite的配置项无关,因此调整配置无法解决该问题。

内容的提问来源于stack exchange,提问作者Elijah Abai

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.17 07:05:22