Command Line Interface

فهرست فصل‌ها دانلود آرشیوناشر

Vite Docs · نسخهٔ 3567471998e3 · MIT

# Command Line Interface

Process locks

The vite, vite build, and vite preview commands create lock files in the lock subdirectory of [cacheDir](/config/shared-options#cachedir). If a lock belongs to another running process with the same command, project root, config file, and mode, Vite exits. To run another instance, pass --bypass-lock.

Dev server

vite

Start Vite dev server in the current directory. vite dev and vite serve are aliases for vite.

Usage

bash
vite [root]

Options

Options
--host [host]Specify hostname (string)
--port <port>Specify port (number)
--open [path]Open browser on startup (`boolean \string`)
--corsEnable CORS (boolean)
--strictPortExit if specified port is already in use (boolean)
--forceForce the optimizer to ignore the cache and re-bundle (boolean)
--experimentalBundleUse experimental full bundle mode (this is highly experimental) (boolean)
--bypass-lockAllow running alongside another Vite process for this project (boolean)
-c, --config <file>Use specified config file (string)
--base <path>Public base path (default: /) (string)
-l, --logLevel <level>info \warn \error \silent (string)
--clearScreenAllow/disable clear screen when logging (boolean)
--configLoader <loader>Use bundle to bundle the config with Rolldown, or native to load using the native runtime (default: bundle)
--profile [name]Start built-in Node.js inspector and write the profile to <name>.cpuprofile (check Performance bottlenecks) (`boolean \string`)
-d, --debug [feat]Show debug logs (`string \boolean`)
-f, --filter <filter>Filter debug logs (string)
-m, --mode <mode>Set env mode (string)
-h, --helpDisplay available CLI options
-v, --versionDisplay version number

Build

vite build

Build for production.

Usage

bash
vite build [root]

Options

Options
--target <target>Transpile target (default: "baseline-widely-available") (string)
--outDir <dir>Output directory (default: dist) (string)
--assetsDir <dir>Directory under outDir to place assets in (default: "assets") (string)
--assetsInlineLimit <number>Static asset base64 inline threshold in bytes (default: 4096) (number)
--ssr [entry]Build specified entry for server-side rendering (string)
--sourcemap [output]Output source maps for build (default: false) (`boolean \"inline" \"hidden"`)
--minify [minifier]Enable/disable minification, or specify minifier to use (default: "oxc") (`boolean \"oxc" \"terser" \"esbuild"`)
--manifest [name]Emit build manifest json (`boolean \string`)
--ssrManifest [name]Emit ssr manifest json (`boolean \string`)
--emptyOutDirForce empty outDir when it's outside of root (boolean)
-w, --watchRebuilds when modules have changed on disk (boolean)
--bypass-lockAllow running alongside another Vite process for this project (boolean)
-c, --config <file>Use specified config file (string)
--base <path>Public base path (default: /) (string)
-l, --logLevel <level>info \warn \error \silent (string)
--clearScreenAllow/disable clear screen when logging (boolean)
--configLoader <loader>Use bundle to bundle the config with Rolldown, or native to load using the native runtime (default: bundle)
--profile [name]Start built-in Node.js inspector and write the profile to <name>.cpuprofile (check Performance bottlenecks) (`boolean \string`)
-d, --debug [feat]Show debug logs (`string \boolean`)
-f, --filter <filter>Filter debug logs (string)
-m, --mode <mode>Set env mode (string)
-h, --helpDisplay available CLI options
--appBuild all environments, same as builder: {} (boolean, experimental)

Others

vite optimize

Pre-bundle dependencies.

Deprecated: the pre-bundle process runs automatically and does not need to be called.

Usage

bash
vite optimize [root]

Options

Options
--forceForce the optimizer to ignore the cache and re-bundle (boolean)
-c, --config <file>Use specified config file (string)
--base <path>Public base path (default: /) (string)
-l, --logLevel <level>info \warn \error \silent (string)
--clearScreenAllow/disable clear screen when logging (boolean)
--configLoader <loader>Use bundle to bundle the config with Rolldown, or native to load using the native runtime (default: bundle)
-d, --debug [feat]Show debug logs (`string \boolean`)
-f, --filter <filter>Filter debug logs (string)
-m, --mode <mode>Set env mode (string)
-h, --helpDisplay available CLI options

vite preview

Locally preview the production build. Do not use this as a production server as it's not designed for it.

This command starts a server in the build directory (by default dist). Run vite build beforehand to ensure that the build directory is up-to-date. Depending on the project's configured [appType](/config/shared-options#apptype), it makes use of certain middleware.

Usage

bash
vite preview [root]

Options

Options
--host [host]Specify hostname (string)
--port <port>Specify port (number)
--strictPortExit if specified port is already in use (boolean)
--open [path]Open browser on startup (`boolean \string`)
--outDir <dir>Output directory (default: dist) (string)
--bypass-lockAllow running alongside another Vite process for this project (boolean)
-c, --config <file>Use specified config file (string)
--base <path>Public base path (default: /) (string)
-l, --logLevel <level>info \warn \error \silent (string)
--clearScreenAllow/disable clear screen when logging (boolean)
--configLoader <loader>Use bundle to bundle the config with Rolldown, or native to load using the native runtime (default: bundle)
-d, --debug [feat]Show debug logs (`string \boolean`)
-f, --filter <filter>Filter debug logs (string)
-m, --mode <mode>Set env mode (string)
-h, --helpDisplay available CLI options