Netlify无法编译含window变量的TypeScript项目，求解决方案

问题根源 #

你写的let window : any = typeof window !== "undefined" ? window : {}存在核心问题：

1. window是浏览器全局对象，用let重新声明会和全局变量冲突，触发暂时性死区（TDZ）——判断语句里的window指向你要声明的变量，此时变量还未初始化，因此报错。
2. 即便移除类型声明，重新声明全局变量的操作依然会和TypeScript/构建工具的全局变量检测逻辑冲突。

可行替代方案 #

方案1：不重新声明window，用类型断言处理 #

直接复用全局window，用类型断言解决非浏览器环境的类型问题：

// 若需要给window扩展自定义属性，先声明全局类型（可选）
declare global {
  interface Window {
    gtag: (...args: any[]) => void; // 替换为你的GA相关类型
  }
}

// 直接判断并赋值，无需重新声明window
const gaContext = typeof window !== "undefined" ? window : {} as Window;

方案2：分开声明与赋值，绕开暂时性死区 #

把变量声明和赋值拆分，避免TDZ限制：

let gaContext: Window | Record<string, any>;
if (typeof window !== "undefined") {
  gaContext = window;
} else {
  gaContext = {};
}

// 后续使用gaContext替代window即可

方案3：仅在浏览器环境执行GA代码 #

利用环境判断，只在浏览器环境初始化GA，完全避开Node构建环境的window不存在问题：

if (typeof window !== "undefined") {
  // 直接写GA初始化逻辑，比如：
  window.gtag('js', new Date());
  window.gtag('config', 'GA_TRACKING_ID');
}

为什么之前的尝试无效 #

• 移除类型声明：只是去掉了类型约束，但let window = ...依然在重新声明全局变量，触发暂时性死区报错。
• 添加lib: ["dom"]：让TypeScript识别window的类型，但无法解决你重新声明变量导致的冲突问题。

内容的提问来源于stack exchange，提问作者learningtech