命令行界面
开发服务器
vite
在当前目录启动 Vite 开发服务器。vite dev 和 vite serve 是 vite 的别名。
用法
bash
vite [root]选项
| 选项 | |
|---|---|
--host [host] | 指定主机名（string） |
--port <port> | 指定端口（number） |
--open [path] | 启动时打开浏览器（boolean | string） |
--cors | 启用 CORS（boolean） |
--strictPort | 如果指定端口已被占用则退出（boolean） |
--force | 强制优化器忽略缓存并重新打包（boolean） |
--experimentalBundle | 使用实验性的完整打包模式（该功能高度实验性）（boolean） |
-c, --config <file> | 使用指定的配置文件（string） |
--base <path> | 公共基础路径（默认值：/）（string） |
-l, --logLevel <level> | info | warn | error | silent（string） |
--clearScreen | 允许／禁用日志记录时清屏（boolean） |
--configLoader <loader> | 使用 bundle 通过 Rolldown 打包配置，或使用 runner（实验性）即时处理，或使用 native（实验性）通过原生运行时加载（默认值：bundle） |
--profile [name] | 启动内置 Node.js 检查器并将性能分析写入 <name>.cpuprofile（参见性能瓶颈）（boolean | string） |
-d, --debug [feat] | 显示调试日志（string | boolean） |
-f, --filter <filter> | 过滤调试日志（string） |
-m, --mode <mode> | 设置环境模式（string） |
-h, --help | 显示可用的 CLI 选项 |
-v, --version | 显示版本号 |
构建
vite build
生产环境构建。
用法
bash
vite build [root]选项
| 选项 | |
|---|---|
--target <target> | 转译目标（默认值："baseline-widely-available"）（string） |
--outDir <dir> | 输出目录（默认值：dist）（string） |
--assetsDir <dir> | 在 outDir 下放置资源的目录（默认值："assets"）（string） |
--assetsInlineLimit <number> | 静态资源 base64 内联阈值，单位为字节（默认值：4096）（number） |
--ssr [entry] | 为服务端渲染构建指定入口（string） |
--sourcemap [output] | 为构建输出源映射（默认值：false）（boolean | "inline" | "hidden"） |
--minify [minifier] | 启用／禁用压缩，或指定要使用的压缩器（默认值："oxc"）（boolean | "oxc" | "terser" | "esbuild"） |
--manifest [name] | 输出构建清单 json（boolean | string） |
--ssrManifest [name] | 输出 ssr 清单 json（boolean | string） |
--emptyOutDir | 当 outDir 位于根目录之外时强制清空 outDir（boolean） |
-w, --watch | 磁盘上的模块发生更改时重新构建（boolean） |
-c, --config <file> | 使用指定的配置文件（string） |
--base <path> | 公共基础路径（默认值：/）（string） |
-l, --logLevel <level> | info | warn | error | silent（string） |
--clearScreen | 允许／禁用日志记录时清屏（boolean） |
--configLoader <loader> | 使用 bundle 通过 Rolldown 打包配置，或使用 runner（实验性）即时处理，或使用 native（实验性）通过原生运行时加载（默认值：bundle） |
--profile [name] | 启动内置 Node.js 检查器并将性能分析写入 <name>.cpuprofile（参见性能瓶颈）（boolean | string） |
-d, --debug [feat] | 显示调试日志（string | boolean） |
-f, --filter <filter> | 过滤调试日志（string） |
-m, --mode <mode> | 设置环境模式（string） |
-h, --help | 显示可用的 CLI 选项 |
--app | 构建所有环境，与 builder: {} 相同（boolean，实验性） |
其他
vite optimize
预打包依赖。
已弃用：预打包过程会自动运行，无需调用。
用法
bash
vite optimize [root]选项
| 选项 | |
|---|---|
--force | 强制优化器忽略缓存并重新打包（boolean） |
-c, --config <file> | 使用指定的配置文件（string） |
--base <path> | 公共基础路径（默认值：/）（string） |
-l, --logLevel <level> | info | warn | error | silent（string） |
--clearScreen | 允许／禁用日志记录时清屏（boolean） |
--configLoader <loader> | 使用 bundle 通过 Rolldown 打包配置，或使用 runner（实验性）即时处理，或使用 native（实验性）通过原生运行时加载（默认值：bundle） |
-d, --debug [feat] | 显示调试日志（string | boolean） |
-f, --filter <filter> | 过滤调试日志（string） |
-m, --mode <mode> | 设置环境模式（string） |
-h, --help | 显示可用的 CLI 选项 |
vite preview
本地预览生产构建。不要将其用作生产服务器，因为它不是为此设计的。
此命令在构建目录中启动服务器（默认：dist）。运行 vite build 以确保构建目录是最新的。根据项目配置的 appType，它会使用某些中间件。
用法
bash
vite preview [root]选项
| 选项 | |
|---|---|
--host [host] | 指定主机名（string） |
--port <port> | 指定端口（number） |
--strictPort | 如果指定端口已被占用则退出（boolean） |
--open [path] | 启动时打开浏览器（boolean | string） |
--outDir <dir> | 输出目录（默认值：dist）（string） |
-c, --config <file> | 使用指定的配置文件（string） |
--base <path> | 公共基础路径（默认值：/）（string） |
-l, --logLevel <level> | info | warn | error | silent（string） |
--clearScreen | 允许／禁用日志记录时清屏（boolean） |
--configLoader <loader> | 使用 bundle 通过 Rolldown 打包配置，或使用 runner（实验性）即时处理，或使用 native（实验性）通过原生运行时加载（默认值：bundle） |
-d, --debug [feat] | 显示调试日志（string | boolean） |
-f, --filter <filter> | 过滤调试日志（string） |
-m, --mode <mode> | 设置环境模式（string） |
-h, --help | 显示可用的 CLI 选项 |