Skip to page content
Quasar CLI with Vite - @quasar/app-vite

SSG 构建命令

警告!Beta 阶段

Quasar SSG 模式目前处于 “beta” 阶段。根据社区反馈,API 在未来可能会有所变动,因此每次升级 “@quasar/app-vite” 时请留意 release notes。

开发

quasar dev -m ssg

# ..或者完整写法:
quasar dev --mode ssg

开发服务器通过 SSR 管线渲染普通的 SSG 路由。匹配 ssg.clientSideRenderingRoutes 的路由在客户端渲染。/src-ssg/ssg-renderer 文件仅在生产构建时使用,因此开发服务器不会写入静态 HTML 文件。

生产构建

quasar build -m ssg

# ..或者完整写法:
quasar build --mode ssg

默认输出目录为 dist/ssg。如果 getSsgPages() 返回空数组,或者两个页面定义尝试写入同一文件,构建将失败。

TIP

如果您想更改 SSG 渲染过程的默认错误处理行为(首个错误即中止),而是希望遍历所有 SSG 页面后再报错,或者只是警告但不失败,又或者完全忽略错误,可以使用 quasar.config > ssg > onSsgRendererError

如果需要启用调试模式进行生产构建:

quasar build -m ssg -d

# ..或者完整写法
quasar build -m ssg --debug