HTML中使用Vite实现快速开发构建的基本使用教程

大芳君_9058

大芳君_9058

2026-06-12

650人浏览

原创

vite开发时index.html中的import能运行,是因为vite劫持es模块加载逻辑,自动重写路径和裸包名;但build后不再支持,需确保产物路径正确。

html中使用vite实现快速开发构建的基本使用教程

Vite 不是“配置好就能跑”的工具,它默认只处理模块化 JavaScript 和 CSS,HTML 文件本身不经过构建流程——这意味着你不能直接在 index.html 里写 import 或用环境变量,除非显式启用插件或遵循约定。

为什么 index.html 里的 import 能直接运行

Vite 在开发服务器中劫持了原生 ES 模块加载逻辑。当你访问 http://localhost:5173/,Vite 会拦截对 .js 文件的请求,自动将相对路径转为带版本哈希的请求,并将 import 中的裸包名(如 vue)重写为 /node_modules/.vite/deps/vue.js?v=xxx。

  • 这个行为只在开发时生效,vite build 后的 HTML 不再有此能力,必须靠构建产物路径正确引用
  • index.html 必须放在项目根目录,Vite 才会把它作为入口 HTML;放错位置(比如 src/index.html)会导致 404 或静态资源路径错乱
  • 如果在 index.html 中写了 <script type="module" src="./src/main.js"></script>,Vite 会自动解析并转换其中的 import,但不会处理 <script></script> 内联脚本里的 import

vite.config.js 哪些配置改了会影响 HTML 行为

Vite 默认把 index.html 当作 HTML 入口,但几个关键配置会改变它的解析方式:

Wechat HTML Publisher
Wechat HTML Publisher

直接上传HTML富文本到微信公众号草稿箱。支持完整的HTML格式,无需Markdown转换。

下载
  • build.rollupOptions.input:若设为 'src/main.js',Vite 就不再以 index.html 为入口,构建后可能丢失 HTML 输出,需手动配 build.rollupOptions.output.entryFileNames
  • publicDir:默认是 'public',里面放的文件(如 public/favicon.ico)会被原样复制到输出目录,路径在 HTML 中应写成 /favicon.ico,不是 ./public/favicon.ico
  • resolve.alias:只影响 JS/TS 模块解析,对 index.html 中的 src 或 href 属性无效;想让 HTML 里的路径也走别名,得用 vite-plugin-html

开发时热更新失效的常见 HTML 相关原因

修改 index.html 本身通常会触发整页刷新,但某些改动不会触发,容易误判为 HMR 失效:

  • 只改了 <meta>、<title></title> 或注释内容:Vite 默认不监听这些变更,需加插件如 vite-plugin-html 并开启 inject 或 minify 选项才能触发重载
  • 在 index.html 中通过 <script type="module"></script> 写内联代码:Vite 不会对内联模块做 HMR,修改后必须手动刷新
  • 使用了 base: './' 但部署到非根路径(如 https://a.com/myapp/):开发时没问题,但构建后资源 404,看起来像“页面白屏”,其实是路径错了

真正麻烦的是 HTML 和构建产物耦合的部分:比如用 process.env 注入变量、动态插入 script 标签、或依赖服务端模板语法。Vite 默认不支持这些,得靠插件补足——而插件一旦没配对,开发和生产行为就会不一致。

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

相关文章

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

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

下载

相关标签:

html vite 前端开发

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

相关专题

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

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

2023.06.14

5835

7

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

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

2023.06.21

3312

4

html网页制作
html网页制作

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

2023.07.31

2970

5

html空格
html空格

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

2023.08.01

2999

5

html是什么
html是什么

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

2023.08.11

4799

6

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

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

2023.08.11

2941

3

html转txt
html转txt

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

2023.08.31

2749

3

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

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

2023.09.01

2448

6

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

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

2023.09.20

2488

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

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

共1课时 | 221人学习