使用TypeScript时无法导入Firebase v2包的问题求助

问题背景 #

将Firebase云函数从JavaScript迁移到TypeScript后，ESLint始终对Firebase Functions v2的导入语句报错，提示无法解析模块路径：

报错的导入语句 #

import * as functions from 'firebase-functions/v2';
import * as scheduler from 'firebase-functions/v2/scheduler';
import * as https from 'firebase-functions/v2/https';
import * as firestore from 'firebase-functions/v2/firestore';

ESLint报错信息 #

error  Unable to resolve path to module 'firebase-functions/v2'   import/no-unresolved
error  Unable to resolve path to module 'firebase-functions/v2/scheduler'  import/no-unresolved
...

解决方法 #

这个问题是因为eslint-plugin-import默认解析器无法识别Firebase Functions v2的子路径导出语法，需要配置TypeScript专属的导入解析器，让ESLint通过TS的路径规则解析这些导入。

步骤1：安装依赖 #

安装eslint-import-resolver-typescript，它能让eslint-plugin-import使用TypeScript配置来解析模块路径：

npm install eslint-import-resolver-typescript --save-dev

步骤2：修改ESLint配置 #

在.eslintrc.js中添加settings字段，指定使用TypeScript解析器并关联你的TS配置文件：

module.exports = {
  root: true,
  env: {
    es6: true,
    node: true,
  },
  // 新增以下配置
  settings: {
    'import/resolver': {
      typescript: {
        project: ['tsconfig.json', 'tsconfig.dev.json']
      }
    }
  },
  // 原有extends、parser、rules等配置保持不变
};

步骤3：验证修复 #

运行lint命令确认报错是否消失：

npm run lint

额外排查方案 #

如果上述步骤无效，可以尝试：

• 删除依赖文件后重新安装：

rm -rf node_modules package-lock.json
npm install

• 确认firebase-functions版本（当前使用的^4.4.1支持v2导入，无需升级）

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