vite.config.js文件常用的基本配置项:
root
-
类型:
string
-
默认:
process.cwd()
项目根目录(
index.html
文件所在的位置)。可以是一个绝对路径,或者一个相对于该配置文件本身的相对路径。
base
-
类型:
string
-
默认:
/
开发或生产环境服务的公共基础路径。合法的值包括以下几种:
- 绝对 URL 路径名,例如
/foo/
- 完整的 URL,例如
https://foo.com/
- 空字符串或
./
(用于开发环境)
- 绝对 URL 路径名,例如
mode
-
类型:
string
-
默认:
'development'
(开发模式),'production'
(生产模式)在配置中指明将会把 serve 和 build 时的模式 都 覆盖掉。也可以通过命令行
--mode
选项来重写。
publicDir
-
类型:
string | false
-
默认:
"public"
作为静态资源服务的文件夹。该目录中的文件在开发期间在
/
处提供,并在构建期间复制到outDir
的根目录,并且始终按原样提供或复制而无需进行转换。该值可以是文件系统的绝对路径,也可以是相对于项目的根目录的相对路径。
resolve.alias
-
类型:
Record<string, string> | Array<{ find: string | RegExp, replacement: string }>
将会被传递到
@rollup/plugin-alias
作为entries 的选项。也可以是一个对象,或一个{ find, replacement }
的数组。当使用文件系统路径的别名时,请始终使用绝对路径。相对路径的别名值会原封不动地被使用,因此无法被正常解析。
build打包配置
生产环境时移除console.log和debugger
server开发服务器选项
server.host
-
类型:
string | boolean
-
默认:
'127.0.0.1'
指定服务器应该监听哪个 IP 地址。 如果将此设置为
0.0.0.0
或者true
将监听所有地址,包括局域网和公网地址。也可以通过 CLI 使用--host 0.0.0.0
或--host
来设置。
server.port
-
类型:
number
-
默认值:
3000
-
指定开发服务器端口。注意:如果端口已经被使用,Vite 会自动尝试下一个可用的端口,所以这可能不是开发服务器最终监听的实际端口。
server.open
-
类型:
boolean | string
在开发服务器启动时自动在浏览器中打开应用程序。当此值为字符串时,会被用作 URL 的路径名。
server.https
-
类型:
boolean | https.ServerOptions
启用 TLS + HTTP/2。