为什么捐赠
API 浏览器
升级指南
创建新项目
quasar.config 配置文件
从 Webpack 项目转换
浏览器兼容性
TypeScript 支持
目录结构
命令列表
CSS 预处理器
使用 VueRouter 进行页面路由
懒加载 - 代码分割
资源处理
Boot 文件
预取特性
API 代理
配置 Vite
处理 import.meta.env
使用 Pinia 管理状态
代码检查与格式化
测试与审计
开发移动应用
Ajax 请求
开放开发服务器到公网
联系站长
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