常见问题

已解决

background-attachment: fixed iOS 不支持

iOS has an issue preventing background-attachment: fixed from being used with background-size: cover. The Fixed Background Attachment Hack | CSS Tricks

改为使用 ::before 伪元素实现。

JavaScript heap out of memory

SSG 构建(valaxy build --ssg)时,vite-ssg 在同一进程中依次执行 client 构建、server 构建、页面渲染。构建阶段的 Vite resolved config 和插件系统会驻留内存,导致渲染阶段可用堆空间有限。

最低内存要求:--max-old-space-size=2304(约 2.3 GB)

bash[object Promise]

Valaxy 会根据 V8 的 heap_size_limit 自动调整 SSG 行为:

堆限制beasties (Critical CSS)HTML minify并发数
≤ 2.5 GB禁用禁用1
≤ 3.1 GB启用启用2
≤ 4.2 GB启用启用4
> 4.2 GB启用启用8+

如果你在 CI 环境中遇到 OOM,可以通过设置 NODE_OPTIONS 增大堆限制:

bash[object Promise]

合并

使用 defu

但实测 defu faster than @fastify/deepmerge

合并单个配置:

bash[object Promise]

To Be Continued.

贡献者