在 vite 中配置多页面应用,核心做法是在 vite.config.js 的 build.rollupoptions.input 选项中显式定义每个页面的入口文件路径。vite 默认只处理单个 html 入口,通过手动指定多个入口,构建工具会自动为每个入口生成对应的 html 文件和独立的 js/css 包。这样做可以直接实现多页应用的构建,无需额外的插件即可支持基本的页面路由和静态资源隔离。

如何配置多个入口文件并生成对应的 HTML?
要配置多个入口,需要在配置文件中导入 path 模块,并使用 glob 或手动数组列出所有 HTML 入口。Vite 会根据这些入口自动扫描同名的 JS/TS 文件作为脚本入口,并为每个 HTML 文件注入相应的脚本标签。例如,定义 index.html 和 about.html 两个入口,构建后会在 dist 目录下生成对应的目录结构和打包文件。

import { defineConfig } from 'vite';
import path from 'path';
export default defineConfig({
build: {
rollupOptions: {
input: {
index: path.resolve(__dirname, 'index.html'),
about: path.resolve(__dirname, 'about.html')
}
}
}
});上述代码中,input 对象键名对应输出目录名,值对应绝对路径。运行 vite build 后,会生成 dist/index/index.html 和 dist/about/about.html,以及各自的 assets 文件夹。确保每个 HTML 文件中没有重复的 <script></script> 标签,Vite 会自动注入。
立即学习“Java免费学习笔记(深入)”;
使用 Husky 将 pre-commit、pre-push 和 commit-msg 检查集成到仓库中,以便代理和开发人员在更改离开工作站之前运行相同的本地防护措施。
如何处理多页面间的共享依赖以减少体积?
多页面应用中,如果多个页面引用相同的库(如 lodash 或 vue),默认情况下每个页面都会打包一份副本,导致体积冗余。可以通过配置 build.rollupOptions.output.manualChunks 将公共依赖提取到单独的 chunk 中。这样,所有页面共享同一个公共 JS 文件,浏览器只需下载一次,从而优化加载性能。

import { defineConfig } from 'vite';
import path from 'path';
export default defineConfig({
build: {
rollupOptions: {
input: {
index: path.resolve(__dirname, 'index.html'),
about: path.resolve(__dirname, 'about.html')
},
output: {
manualChunks: { vendor: ['vue'] }
}
}
}
});在 manualChunks 中,键名 vendor 是输出文件名,值是需要提取的模块数组。构建后,会生成 vendor.js,并在各页面的 HTML 中引入该文件。这确保了 vue 库只被打包一次,减少了总构建体积。若需更细粒度控制,可使用函数形式根据模块路径动态分配 chunk。
当入口文件路径不存在时会发生什么错误?
如果在 build.rollupOptions.input 中指定的路径指向一个不存在的 HTML 文件,Vite 在启动开发服务器或执行构建时会直接报错,终止流程。错误信息通常明确指出找不到指定的入口文件。这是因为 Vite 需要读取 HTML 内容来解析其内部的 <script type="module"></script> 标签,若文件缺失,无法完成初始化。因此,必须确保配置中的路径准确无误,且文件实际存在于项目中。

















