使用Webpack打包Google Apps Script时导入cheerio-httpcli遇TS错误求助

这种类型冲突我之前做GAS打包时也碰到过，本质是@types/node里定义的global类型和Google Apps Script运行环境自带的global类型声明撞车了，尤其是同时引入Node相关类型和GAS类型时，就会触发这个TS2403错误。下面是几个亲测有效的修复方案：

方案一：跳过库类型检查+指定环境类型 #

直接修改你的tsconfig.json，通过配置快速规避冲突：

{
  "compilerOptions": {
    "module": "commonjs",
    "rootDir": "./dev",
    "outDir": "./src",
    "alwaysStrict": true,
    "baseUrl": "./",
    // 添加以下配置
    "types": ["google-apps-script"], // 明确指定使用GAS的环境类型
    "skipLibCheck": true // 跳过第三方库的类型检查，解决重复声明问题
    // 你的其他原有配置...
  }
}

skipLibCheck会让TypeScript忽略第三方库之间的类型冲突，是最快速的临时解决办法；指定types为google-apps-script能确保编译器优先使用GAS的环境定义，而非Node的。

方案二：替换为GAS兼容的依赖组合 #

cheerio-httpcli本身基于Node.js环境开发，而GAS的运行环境没有Node的API支持，强行使用容易出问题。建议换成GAS原生的UrlFetchApp搭配纯cheerio实现相同功能：

1. 先安装纯cheerio：

npm install cheerio --save

2. 在代码中这样使用：

import * as cheerio from 'cheerio';

function fetchAndParsePage() {
  // 用GAS自带的UrlFetchApp获取页面内容
  const response = UrlFetchApp.fetch('https://目标网址.com');
  const htmlContent = response.getContentText();
  // 用cheerio解析HTML
  const $ = cheerio.load(htmlContent);
  
  // 接下来就可以像使用cheerio-httpcli一样操作DOM了
  console.log($('h1').text());
}

这种方式既避开了Node环境依赖，也从根源上解决了类型冲突问题。

方案三：手动覆盖global类型声明 #

如果你一定要坚持使用cheerio-httpcli，可以在项目根目录创建一个global.d.ts文件，手动统一global的类型定义：

declare var global: typeof globalThis;

TypeScript会自动识别这个声明文件，覆盖掉@types/node和GAS之间冲突的global类型，让编译器统一使用globalThis的类型标准。

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