命令行界面（CLI）
vite-main使用指南
命令行界面（CLI）
开发服务器
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 |
启动内置的 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> |
转译目标（默认："baseline-widely-available"）（string） |
--outDir <dir> |
输出目录（默认：dist）（string） |
--assetsDir <dir> |
outDir 下存放静态资源的目录（默认："assets"）（string） |
--assetsInlineLimit <number> |
静态资源 base64 内联阈值，单位为字节（默认：4096）（number） |
--ssr [entry] |
为服务端渲染构建指定入口（string） |
--sourcemap [output] |
为构建输出 source map（默认：false）（boolean | "inline" | "hidden"） |
--minify [minifier] |
启用/禁用压缩，或指定要使用的压缩器（默认："oxc"）（boolean | "oxc" | "terser" | "esbuild"） |
--manifest [name] |
生成构建 manifest 的 json 文件（boolean | string） |
--ssrManifest [name] |
生成 SSR manifest 的 json 文件（boolean | string） |
--emptyOutDir |
当 outDir 位于 root 之外时强制清空 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 |
启动内置的 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（实验性）即时处理配置，或使用 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 选项 |
帮助我们改进文档
发现翻译问题或内容错误？请告诉我们。