From fe76383a29653b0d052a034efb40e3f113f2b0c2 Mon Sep 17 00:00:00 2001
From: sanbuphy <physicoada@gmail.com>
Date: Fri, 6 Feb 2026 04:48:33 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E4=BF=AE=E5=A4=8D=20VitePress=20build?=
 =?UTF-8?q?=20=E8=BF=9B=E7=A8=8B=20hang=20=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

在 theme/index.js 的 setup() 中添加 SSR 检查，确保浏览器端库
(Viewer.js, TypeIt) 只在客户端初始化，避免 SSR 期间产生
无法清理的资源导致进程挂起。
---
 docs/.vitepress/theme/index.js | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/.vitepress/theme/index.js b/docs/.vitepress/theme/index.js
index 24e1e26..1ef6385 100644
--- a/docs/.vitepress/theme/index.js
+++ b/docs/.vitepress/theme/index.js
@@ -869,6 +869,11 @@ export default {
     const { frontmatter } = useData()
     let viewer = null
 
+    // Skip browser-only initialization during SSR
+    if (import.meta.env.SSR) {
+      return
+    }
+
     const initViewer = () => {
       // 销毁旧实例
       if (viewer) {