You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
|
|
# 命令行接口 {#command-line-interface}
|
|
|
|
|
|
|
|
|
|
## `vitepress dev`
|
|
|
|
|
|
|
|
|
|
使用指定目录作为根目录来启动 VitePress 开发服务器。默认为当前目录。在当前目录下运行时也可以省略 `dev` 命令。
|
|
|
|
|
|
|
|
|
|
### 用法
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
# 从当前目录启动，省略 `dev`
|
|
|
|
|
vitepress
|
|
|
|
|
|
|
|
|
|
# 从子目录启动
|
|
|
|
|
vitepress dev [root]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 选项 {#options}
|
|
|
|
|
|
|
|
|
|
| 选项 | 说明 |
|
|
|
|
|
| --------------- | ------------------------------------------ |
|
|
|
|
|
| `--open [path]` | 启动时打开浏览器 (`boolean \| string`) |
|
|
|
|
|
| `--port <port>` | 指定端口 (`number`) |
|
|
|
|
|
| `--base <path>` | public base URL (默认值: `/`) (`string`) |
|
|
|
|
|
| `--cors` | 启用 CORS |
|
|
|
|
|
| `--strictPort` | 如果指定的端口已被占用则退出 (`boolean`) |
|
|
|
|
|
| `--force` | 强制优化程序忽略缓存并重新绑定 (`boolean`) |
|
|
|
|
|
|
|
|
|
|
## `vitepress build`
|
|
|
|
|
|
|
|
|
|
构建用于生产环境的 VitePress 站点。
|
|
|
|
|
|
|
|
|
|
### 用法
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
vitepress build [root]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 选项\
|
|
|
|
|
|
|
|
|
|
| 选项 | 说明 |
|
|
|
|
|
| ------------------------------ | ------------------------------------------------------------------------------------------------- |
|
|
|
|
|
| `--mpa` (experimental) | [MPA 模式](../guide/mpa-mode) 下构建，无需客户端激活 (`boolean`) |
|
|
|
|
|
| `--base <path>` | public base URL (默认值: `/`) (`string`) |
|
|
|
|
|
| `--target <target>` | 转译目标 (默认值：`"modules"`) (`string`) |
|
|
|
|
|
| `--outDir <dir>` | 输出目录 (默认值：`.vitepress/dist`) (`string`) |
|
|
|
|
|
| `--minify [minifier]` | 启用/禁用压缩，或指定要使用的压缩程序 (默认值：`"esbuild"`) (`boolean \| "terser" \| "esbuild"`) |
|
|
|
|
|
| `--assetsInlineLimit <number>` | 静态资源 base64 内联阈值（以字节为单位）(默认值：`4096`) (`number`) |
|
|
|
|
|
|
|
|
|
|
## `vitepress preview`
|
|
|
|
|
|
|
|
|
|
在本地预览生产版本。
|
|
|
|
|
|
|
|
|
|
### 用法
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
vitepress preview [root]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 选项
|
|
|
|
|
|
|
|
|
|
| 选项 | 说明 |
|
|
|
|
|
| --------------- | -------------------------------------- |
|
|
|
|
|
| `--base <path>` | public base URL (默认值: `/`) (`string`) |
|
|
|
|
|
| `--port <port>` | 指定端口 (`number`) |
|
|
|
|
|
|
|
|
|
|
## `vitepress init`
|
|
|
|
|
|
|
|
|
|
在当前目录中启动[安装向导](../guide/getting-started#setup-wizard)。
|
|
|
|
|
|
|
|
|
|
### 用法
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
vitepress init
|
|
|
|
|
```
|
