Skip to content

命令行界面

vitepress dev

使用指定目录作为根目录启动 VitePress 开发服务器。默认为当前目录。在当前目录下运行时,dev 命令也可以省略。

用法

sh
# 在当前目录中启动,省略 `dev`
vitepress

# 在子目录中启动
vitepress dev [root]

选项

选项描述
--open [path]启动时打开浏览器 (boolean | string)
--port <port>指定端口 (number)
--base <path>公共基础路径 (string)
--cors启用 CORS
--strictPort如果指定的端口已在使用中,则退出 (boolean)
--force强制优化器忽略缓存并重新打包 (boolean)

vitepress build

构建用于生产的 VitePress 站点。

用法

sh
vitepress build [root]

选项

选项描述
--mpaMPA 模式 下构建而不需要客户端激活 (boolean)
--base <path>公共基础路径 (string)
--target <target>转译目标 (string)
--outDir <dir>输出目录 (string)
--minify [minifier]启用/禁用缩小,或指定要使用的缩小器 (boolean | "terser" | "esbuild")
--assetsInlineLimit <number>静态资源内联为 base64 编码的阈值,以字节为单位 (number)

vitepress preview

在本地预览生产构建。

用法

sh
vitepress preview [root]

选项

选项描述
--base <path>公共基础路径 (string)
--port <port>指定端口 (number)

vitepress init

在当前目录中启动设置向导

用法

sh
vitepress init

vitepress开发指南