命令行界面
开发服务器
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) |
-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 | 启动内置 Node.js 检查器（查看 性能瓶颈） |
-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> | 转译目标 (默认: "modules") (string) |
--outDir <dir> | 输出目录 (默认: dist) (string) |
--assetsDir <dir> | 放置静态资源的输出目录 (默认: "assets") (string) |
--assetsInlineLimit <number> | 静态资源内联为 base64 的阈值（以字节为单位） (默认: 4096) (number) |
--ssr [entry] | 构建指定的入口点以进行服务端渲染 (string) |
--sourcemap [output] | 构建时输出源码映射 (默认: false) (boolean | "inline" | "hidden") |
--minify [minifier] | 启用/禁用压缩，或指定要使用的压缩器 (默认: "esbuild") (boolean | "terser" | "esbuild") |
--manifest [name] | 输出构建清单 json 文件 (boolean | string) |
--ssrManifest [name] | 输出 SSR 清单 json 文件 (boolean | string) |
--emptyOutDir | 当输出目录在根目录之外时，强制清空该目录 (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（实验性）实时处理（默认: bundle） |
--profile | 启动内置 Node.js 检查器（查看 性能瓶颈） |
-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（实验性）实时处理（默认: 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（实验性）实时处理（默认: bundle） |
-d, --debug [feat] | 显示调试日志 (string | boolean) |
-f, --filter <filter> | 过滤调试日志 (string) |
-m, --mode <mode> | 设置环境模式 (string) |
-h, --help | 显示可用 CLI 选项 |