From 2b4e351c08d6dcffa8e59114286d5a715ff818dc Mon Sep 17 00:00:00 2001
From: sendevia <me@sendevia.top>
Date: Wed, 10 Dec 2025 15:43:46 +0800
Subject: [PATCH] refactor: replace window checks with centralized env utility

---
 .vitepress/theme/components/Header.vue        |  3 +-
 .vitepress/theme/components/PageIndicator.vue |  3 +-
 .../theme/composables/useGlobalScroll.ts      |  3 +-
 .vitepress/theme/layouts/Article.vue          |  3 +-
 .vitepress/theme/layouts/Default.vue          |  5 +--
 .vitepress/theme/stores/screenWidth.ts        |  8 +----
 .vitepress/theme/utils/env.ts                 | 31 +++++++++++++++++++
 7 files changed, 43 insertions(+), 13 deletions(-)
 create mode 100644 .vitepress/theme/utils/env.ts

diff --git a/.vitepress/theme/components/Header.vue b/.vitepress/theme/components/Header.vue
index b17c3b5..bfc7a84 100644
--- a/.vitepress/theme/components/Header.vue
+++ b/.vitepress/theme/components/Header.vue
@@ -1,12 +1,13 @@
 <script setup lang="ts">
 import { ref, onMounted } from "vue";
 import { useGlobalData } from "../composables/useGlobalData";
+import { isClient } from "../utils/env";
 
 const { page, frontmatter, theme } = useGlobalData();
 const seed = ref(1);
 const defaultImpression = theme.value.defaultImpression;
 
-if (typeof window !== "undefined") {
+if (isClient()) {
   onMounted(() => {
     seed.value = Date.now();
   });
diff --git a/.vitepress/theme/components/PageIndicator.vue b/.vitepress/theme/components/PageIndicator.vue
index 3beb22b..fbb435f 100644
--- a/.vitepress/theme/components/PageIndicator.vue
+++ b/.vitepress/theme/components/PageIndicator.vue
@@ -2,6 +2,7 @@
 import { ref, computed, onMounted, onBeforeUnmount, nextTick, watch } from "vue";
 import { useGlobalData } from "../composables/useGlobalData";
 import { useScreenWidthStore } from "../stores/screenWidth";
+import { isClient } from "../utils/env";
 
 const { page, frontmatter } = useGlobalData();
 const screenWidthStore = useScreenWidthStore();
@@ -171,7 +172,7 @@ const resizeHandler = () => {
   }
 };
 
-if (typeof window !== "undefined") {
+if (isClient()) {
   onMounted(() => {
     screenWidthStore.init();
 
diff --git a/.vitepress/theme/composables/useGlobalScroll.ts b/.vitepress/theme/composables/useGlobalScroll.ts
index 03e39d3..e87d6ec 100644
--- a/.vitepress/theme/composables/useGlobalScroll.ts
+++ b/.vitepress/theme/composables/useGlobalScroll.ts
@@ -1,4 +1,5 @@
 import { ref, computed, onMounted } from "vue";
+import { isClient } from "../utils/env";
 
 let container: HTMLElement | Window | null = null;
 let isInitialized = false;
@@ -47,7 +48,7 @@ function initGlobalScrollListener(initialThreshold: number = threshold, scrollCo
   threshold = initialThreshold;
   targetScrollable = scrollContainer;
 
-  if (typeof window !== "undefined") {
+  if (isClient()) {
     const updateContainer = () => {
       if (container) {
         const target: any = container;
diff --git a/.vitepress/theme/layouts/Article.vue b/.vitepress/theme/layouts/Article.vue
index 2abf87b..6a0a6e6 100644
--- a/.vitepress/theme/layouts/Article.vue
+++ b/.vitepress/theme/layouts/Article.vue
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { ref, onMounted, onBeforeUnmount } from "vue";
+import { isClient } from "../utils/env";
 
 const showImageViewer = ref(false);
 const currentImageIndex = ref(0);
@@ -86,7 +87,7 @@ function olCountAttributes() {
   });
 }
 
-if (typeof window !== "undefined") {
+if (isClient()) {
   onMounted(() => {
     const anchors = document.querySelectorAll<HTMLAnchorElement>("a.title-anchor");
     anchors.forEach((anchor) => {
diff --git a/.vitepress/theme/layouts/Default.vue b/.vitepress/theme/layouts/Default.vue
index 41cf995..388632e 100644
--- a/.vitepress/theme/layouts/Default.vue
+++ b/.vitepress/theme/layouts/Default.vue
@@ -7,6 +7,7 @@ import { onMounted, nextTick, computed, ref, watch } from "vue";
 import { useRoute } from "vitepress";
 import { useGlobalData } from "../composables/useGlobalData";
 import { usePostStore } from "../stores/posts";
+import { isClient } from "../utils/env";
 
 const { site, page, frontmatter, theme } = useGlobalData();
 const route = useRoute();
@@ -40,7 +41,7 @@ function checkAndRedirect(path: string): boolean {
       }
 
       redirectTimer = setTimeout(() => {
-        if (typeof window !== "undefined") {
+        if (isClient()) {
           window.location.replace(post.url);
         }
       }, 100);
@@ -133,7 +134,7 @@ function onBeforeLeave() {
   isTransitioning.value = true;
 }
 
-if (typeof window !== "undefined") {
+if (isClient()) {
   onMounted(() => {
     if (!route.path.startsWith("/p/")) {
       updatePalette();
diff --git a/.vitepress/theme/stores/screenWidth.ts b/.vitepress/theme/stores/screenWidth.ts
index ef735c2..6cadf49 100644
--- a/.vitepress/theme/stores/screenWidth.ts
+++ b/.vitepress/theme/stores/screenWidth.ts
@@ -1,5 +1,6 @@
 import { defineStore } from "pinia";
 import { ref, watch, onUnmounted } from "vue";
+import { isClient } from "../utils/env";
 
 /**
  * 屏幕宽度响应式状态管理
@@ -14,13 +15,6 @@ export const useScreenWidthStore = defineStore("screenWidth", () => {
   let resizeHandler: (() => void) | null = null;
   let isInitialized = false;
 
-  /**
-   * 检查是否在客户端环境
-   */
-  function isClient() {
-    return typeof window !== "undefined";
-  }
-
   /**
    * 更新屏幕宽度状态
    */
diff --git a/.vitepress/theme/utils/env.ts b/.vitepress/theme/utils/env.ts
new file mode 100644
index 0000000..2f2e9b8
--- /dev/null
+++ b/.vitepress/theme/utils/env.ts
@@ -0,0 +1,31 @@
+/**
+ * 判断当前是否在客户端环境
+ * @returns 如果是客户端环境返回 true，否则返回 false
+ */
+export function isClient(): boolean {
+  return typeof window !== "undefined";
+}
+
+/**
+ * 判断当前是否在服务器端环境
+ * @returns 如果是服务器端环境返回 true，否则返回 false
+ */
+export function isServer(): boolean {
+  return !isClient();
+}
+
+/**
+ * 判断当前是否在开发环境
+ * @returns 如果是开发环境返回 true，否则返回 false
+ */
+export function isDev(): boolean {
+  return process.env.NODE_ENV === "development";
+}
+
+/**
+ * 判断当前是否在生产环境
+ * @returns 如果是生产环境返回 true，否则返回 false
+ */
+export function isProd(): boolean {
+  return process.env.NODE_ENV === "production";
+}