Vite入门教程 Vite 构建生产版本

2024-02-25 开发教程 Vite入门教程 匿名 2

当需要将应用部署到生产环境时,只需运行 vite build命令。默认情况下,它使用<root>/index.html作为其构建入口点,并生成能够静态部署的应用程序包。

浏览器兼容性

用于生产环境的构建包会假设目标浏览器支持现代 JavaScript 语法。默认情况下,Vite 的目标浏览器是指能够 支持原生 ESM script 标签支持原生 ESM 动态导入的。作为参考,Vite 使用这个 browserslist 作为查询标准:

defaults and supports es6-module and supports es6-module-dynamic-import, not opera > 0, not samsung > 0, not and_qq > 0

你也可以通过 ​build.target​ 配置项 指定构建目标,最低支持 ​es2015​。

请注意,默认情况下 Vite 只处理语法转译,且 默认不包含任何 polyfill。你可以前往 Polyfill.io查看,这是一个基于用户浏览器 User-Agent 字符串自动生成 polyfill 包的服务。

传统浏览器可以通过插件 @vitejs/plugin-legacy 来支持,它将自动生成传统版本的 chunk 及与其相对应 ES 语言特性方面的 polyfill。兼容版的 chunk 只会在不支持原生 ESM 的浏览器中进行按需加载。

公共基础路径

如果你需要在嵌套的公共路径下部署项目,只需指定 ​base ​配置项,然后所有资源的路径都将据此配置重写。这个选项也可以通过命令行参数指定,例如 ​vite build --base=/my/public/path/​。

由 JS 引入的资源 URL,CSS 中的 ​url()​ 引用以及 ​.html​ 文件中引用的资源在构建过程中都会自动调整,以适配此选项。

当然,情况也有例外,当访问过程中需要使用动态连接的 url 时,可以使用全局注入的 ​import.meta.env.BASE_URL​ 变量,它的值为公共基础路径。注意,这个变量在构建时会被静态替换,因此,它必须按 ​import.meta.env.BASE_URL​ 的原样出现(例如 ​import.meta.env['BASE_URL']​ 是无效的)

自定义构建

构建过程可以通过多种构建配置选项来自定义构建。具体来说,你可以通过 build.rollupOptions直接调整底层的 Rollup 选项

// vite.config.js
module.exports = defineConfig({
build: {
rollupOptions: {
// https://rollupjs.org/guide/en/#big-list-of-options
}
}
})

例如,你可以使用仅在构建期间应用的插件来指定多个 Rollup 输出。

文件变化时重新构建

你可以使用 vite build --watch来启用 rollup 的监听器。或者,你可以直接通过 build.watch调整底层的 ​WatcherOptions ​选项:

// vite.config.js
module.exports = defineConfig({
build: {
watch: {
// https://rollupjs.org/guide/en/#watch-options
}
}
})

多页面应用模式

假设你有下面这样的项目文件结构

├── package.json
├── vite.config.js
├── index.html
├── main.js
└── nested
├── index.html
└── nested.js

在开发过程中,简单地导航或链接到 ​/nested/​ - 将会按预期工作,与正常的静态文件服务器表现一致。

在构建过程中,你只需指定多个 ​.html​ 文件作为入口点即可:

// vite.config.js
const { resolve } = require('path')
const { defineConfig } = require('vite')
module.exports = defineConfig({
build: {
rollupOptions: {
input: {
main: resolve(__dirname, 'index.html'),
nested: resolve(__dirname, 'nested/index.html')
}
}
}
})

如果你指定了另一个根目录,请记住,在解析输入路径时,__dirname的值将仍然是 vite.config.js 文件所在的目录。因此,你需要把对应入口文件的 root的路径添加到 resolve的参数中。

库模式

当你开发面向浏览器的库时,你可能会将大部分时间花在该库的测试/演示页面上。在 Vite 中你可以使用 ​index.html​ 获得如丝般顺滑的开发体验。

当这个库要进行发布构建时,请使用 ​build.lib​ 配置项,以确保将那些你不想打包进库的依赖进行外部化处理,例如 ​vue ​或 ​react​:

// vite.config.js
const path = require('path')
const { defineConfig } = require('vite')
module.exports = defineConfig({
build: {
lib: {
entry: path.resolve(__dirname, 'lib/main.js'),
name: 'MyLib',
fileName: (format) => `my-lib.${format}.js`
},
rollupOptions: {
// 确保外部化处理那些你不想打包进库的依赖
external: ['vue'],
output: {
// 在 UMD 构建模式下为这些外部化的依赖提供一个全局变量
globals: {
vue: 'Vue'
}
}
}
}
})

使用如上配置运行 vite build时,将会使用一套面向库的 Rollup 预设,并且将为该库提供两种构建格式:esumd(可在 build.lib中配置):

$ vite build
building for production...
[write] my-lib.es.js 0.08kb, brotli: 0.07kb
[write] my-lib.umd.js 0.30kb, brotli: 0.16kb

推荐在你库的 package.json中使用如下格式:

推荐在你库的 package.json 中使用如下格式:
{
"name": "my-lib",
"files": ["dist"],
"main": "./dist/my-lib.umd.js",
"module": "./dist/my-lib.es.js",
"exports": {
".": {
"import": "./dist/my-lib.es.js",
"require": "./dist/my-lib.umd.js"
}
}
}