Vite CLI 常见命令

以下是一些常用的 Vite CLI 指令及其参数，方便在开发、打包、预览等阶段使用。

模式相关参数（--mode）

--mode development
指定开发环境配置，加载 .env.development，用于调试与热更新。
--mode production
指定生产环境配置，加载 .env.production，会启用代码压缩、去除调试信息等优化。
(可选) --mode test / --mode staging
用于测试或预发布环境，加载对应的 .env.test 或 .env.staging 文件。

配置文件相关参数（--config）

--config <file>
指定自定义 Vite 配置文件，例如：
vite --config vite.custom.config.js

服务器相关参数

--port <port>
指定开发服务器的端口（默认 5173）。
--strictPort
当端口被占用时，如果指定了 --strictPort，则不会自动递增端口，而是直接抛错退出。
--open
启动开发服务器后自动在浏览器打开项目。
--force
强制重新预构建依赖。

其他常用参数

--base <path>
指定项目部署时的基础路径（base URL），默认 '/'。
--clearScreen
是否在命令行中清空屏幕，默认开启，可通过 --clearScreen false 关闭。
--sourcemap
在打包时生成 Source Map 文件，方便在生产环境中调试或定位问题。使用方法如：
```
vite build --sourcemap
```
--watch
在打包后持续监听文件变动，并自动重新构建（常用于调试或持续集成环境）。例如：
```
vite build --watch
```
--emptyOutDir
打包前先移除目标输出文件夹，避免旧文件残留。其默认行为自 Vite 2.6 起已为 true，若你需要保留输出文件夹，可以手动设置或将其置为 false。
--minify [terser|esbuild|false]
指定最小化工具或关闭代码压缩，其中 terser 和 esbuild 都可用于压缩与优化构建产物，false 则表示禁用最小化。
--manifest
生成 manifest.json 文件，通常在和后端框架配合部署时使用，以便服务端正确加载对应的资源文件。
--lib
以库（Library）形式进行打包，适用于组件库或可单独发布的功能模块等。可以与 --entry 配合指定入口：
```
vite build --lib --entry src/myLib.ts
```
--outDir <dir>
自定义打包产物的输出目录，默认会使用 vite.config.js 中的 outDir 配置。如果你想在命令行中临时指定输出目录，可以使用：
```
vite build --outDir dist_custom
```
--ssr <entry>
针对服务端渲染（SSR）的打包入口文件。当你在项目中配置 SSR 时，可以通过该参数对服务器端入口点进行打包。例如：
```
vite build --ssr src/entry-server.js
```
--host <hostname/ip>
指定开发服务器监听的主机名或 IP。可使用 --host 0.0.0.0 来让局域网其他设备通过 IP 访问开发服务器。
--https
启动开发服务器时启用 HTTPS 协议（默认使用 HTTP）。在本地需要自行配置证书或信任自签名证书。如果已在配置文件中指定 https:false，则命令行参数无法覆盖。
--cors
启用 CORS (Cross-Origin Resource Sharing) 以允许跨域请求访问开发服务器，在需要跨域测试时会很有用。
--debug
显示更详细的调试日志信息，可以帮助排查与定位问题。
-v, --version
查看当前 Vite 的版本信息，等价于 vite --version。
--logLevel <level>
设置输出日志的级别，支持 error、warn、info、silent。例如：
```
vite build --logLevel silent  # 只输出最少的信息
```

构建与预览

vite build
打包并构建生产环境所需的静态文件，支持多种配置方式以进行代码优化与压缩。
vite preview
启动本地服务器来预览前一步打包生成的文件，通常在生产环境部署前进行验证使用。

查看所有可用参数

若你想了解所有可用命令与参数，最简单的方式仍然是查看官方文档或执行 vite --help

vite --help