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标记
- 用支持编码设置的文本编辑器打开
index.html(推荐VS Code、Notepad++) - VS Code操作:点击右下角的编码标识(如「UTF-8」),选择「通过编码保存」,然后选择「UTF-8」(注意不要选「UTF-8 with BOM」)
- Notepad++操作:顶部菜单栏选择「编码」→「UTF-8 无BOM」,然后保存文件
- 用支持编码设置的文本编辑器打开
确认文件内容
保存后检查文件第一行,确保开头直接是<!DOCTYPE html>,没有任何前置的奇怪字符。重启Vite服务
关闭当前运行的Vite开发服务器,重新执行npm run dev启动服务,问题即可解决。
补充说明:
你之前修改Vite配置文件无效,是因为这个错误的根源是HTML文件本身的编码问题,和Vite的配置项无关,因此调整配置无法解决该问题。
内容的提问来源于stack exchange,提问作者Elijah Abai
相关产品推荐
相关产品推荐

