@types/gtag.js报错：'config'不可分配给'consent'参数类型如何解决

你遇到的类型报错是因为没有正确引入gtag.js的全局类型定义，TypeScript 无法识别gtag方法的config重载，误匹配到了最后一个consent相关的重载规则。你当前用any声明的方案会丢失所有类型校验能力，不推荐长期使用。

1. 先移除你之前声明的gtag: any的全局类型代码。
2. 确认已经安装类型包：

npm install @types/gtag.js --save-dev
# 或用yarn/pnpm
pnpm add @types/gtag.js -D

3. 在项目的全局类型定义文件（比如next-env.d.ts，或者根目录新建globals.d.ts）中添加如下类型声明：

import type { Gtag } from "gtag.js";

declare global {
  interface Window {
    gtag: Gtag;
  }
}

4. 调整你的gtag调用代码，做环境判断+参数类型兜底，避免SSR环境报错和类型不匹配问题：

if (typeof window !== "undefined" && window.gtag) {
  window.gtag(
    "config", 
    process.env.NEXT_PUBLIC_GOOGLE_ANALYTICS as string, 
    { page_path: url }
  );
}

如果你的项目开启了strict: true校验，环境变量默认是string | undefined类型，这里用as string做类型断言的前提是你已经在.env文件中正确配置了该变量，也可以额外加一层非空判断更安全。

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