在Svelte-Kit中TypeScript无法识别Window类型别名的问题

遇到Property 'dataLayer' does not exist on type 'Window & typeof globalThis'的问题，是因为TypeScript默认的Window类型没有包含dataLayer属性，你需要正确扩展全局Window类型，步骤如下：

• 找到项目中的src/app.d.ts文件（如果没有就手动创建），在里面添加全局类型扩展：

  declare global {
    interface Window {
      // 根据GA的实际需求定义类型，新手用any数组也足够
      dataLayer: any[];
      // 同时扩展gtag函数类型，避免后续调用也报错
      gtag?: (...args: any[]) => void;
    }
  }
  
  // 必须导出空对象，确保文件被识别为模块
  export {};
  

• 在+layout.svelte中正常集成GA脚本即可，示例代码：

  <script lang="ts">
    import { onMount } from 'svelte';
  
    onMount(() => {
      // 初始化dataLayer
      window.dataLayer = window.dataLayer || [];
      const gtag = (...args: any[]) => window.dataLayer.push(args);
      
      gtag('js', new Date());
      gtag('config', '你的GA跟踪ID');
  
      // 异步加载GA脚本
      const script = document.createElement('script');
      script.src = `https://www.googletagmanager.com/gtag/js?id=你的GA跟踪ID`;
      script.async = true;
      document.head.appendChild(script);
    });
  </script>
  

直接声明同名Window接口不会被TypeScript合并到全局类型中，必须放在declare global块内，且app.d.ts是Svelte-Kit约定的全局类型文件，会被自动加载识别，不用额外配置。

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