vite-plugin-index-html

快速创建 Vite 应用的 HTML 文件。功能类似于 webpack-html-plugin。

Motivation

Vite 应用默认使用根目录下的 index.html 作为入口文件，通过解析 index.html 的 <script /> 并生成一个 “虚拟的” 脚本资源入口文件，形如：

import 'polyfill';
import './src/main.ts';

在某些非 LibraryMode，需要明确脚本入口文件为 ./src/main.j|ts。该插件实现了类似于 webpack-html-plugin 的能力。

Features

• [x] 修改应用入口
• [x] 支持 Minify
• [x] 支持导出入口文件签名
• [ ] 支持模板
• [ ] 支持 MPA

用法

npm/yarn

npm i --save-dev vite-plugin-index-html

# or

yarn add --dev vite-plugin-index-html

使用

在 vite.config.ts 中引入：

import htmlPlugin from 'vite-plugin-index-html';

// vite.config.ts
export default defineConfig({
  plugins: [vue(), htmlPlugin({
    entry: './src/main.ts'
  })]
})

参数

• entry

应用入口，默认为 .src/main.j|ts?x。

• template

template 地址，默认为 ./src/index.html。

• filename

生成的 HTML 文件名，默认为 index.html。

• publicPath

公共基础路径。默认为 base。

• minify

是否压缩 html 代码。默认为 auto，development 下默认不压缩，production 下默认压缩。

类型：boolean | 'auto' | object

object 详细配置参考 html-minifier-terser

• preserveEntrySignatures

是否保留入口文件签名。

类型："strict" | "allow-extension" | "exports-only" | false

更详细介绍参考 rollup preserveEntrySignatures。

License

MIT