Firebase Cloud Functions TypeScript项目初始化后ESLint与TypeScript报错问题求助

你遇到的这些问题核心是新版本Node.js与Firebase工具链的兼容性冲突，再加上ESLint路径解析的配置细节问题，下面分步骤逐一解决：

1. 修复ESLint无法读取tsconfig.json的错误（Parsing error: Cannot read file '\tsconfig.json'） #

这个错误是ESLint没有正确定位到tsconfig.json的所在目录导致的。你之前尝试过添加tsconfigRootDir，但需要确保配置完全正确：

修改你的.eslintrc.js，在parserOptions中明确指定根目录：

parserOptions: {
  project: ["tsconfig.json", "tsconfig.dev.json"],
  sourceType: "module",
  tsconfigRootDir: __dirname // 关键：告诉ESLint tsconfig在当前项目根目录
},

同时调整VSCode的ESLint工作目录配置，确保它指向项目根而非src：

• 删除.vscode/settings.json里的"eslint.workingDirectories": ["src"]，换成自动识别模式：

"eslint.workingDirectories": [{"mode": "auto"}]

2. 解决.eslintrc.js的CommonJS模块转换提示（File is a CommonJS module; it may be converted to an ES6 module.ts(80001)） #

这个是VSCode TypeScript服务对CommonJS格式.js文件的默认提示，两种简单解决方案：

方案A：重命名配置文件（推荐） #

把.eslintrc.js改名为.eslintrc.cjs——Node.js中.cjs后缀会被明确识别为CommonJS模块，TypeScript就不会再弹出转换提示了。

方案B：在VSCode中忽略该文件的TS检查 #

在.vscode/settings.json中添加配置，精准禁用该文件的TypeScript验证：

"overrides": [
  {
    "files": [".eslintrc.js"],
    "typescript.validate.enable": false
  }
]

3. 修复部署时的unused-vars警告与预部署错误 #

你遇到的'functions' is defined but never used其实是个误报——你的代码明明用到了functions.https和functions.logger，这是ESLint规则与Firebase命名空间导入的兼容性问题。

修改.eslintrc.js的rules，添加对该规则的例外：

rules: {
  "quotes": ["error", "double"],
  "import/no-unresolved": 0,
  "@typescript-eslint/no-unused-vars": ["error", { "varsIgnorePattern": "^functions$" }]
},

另外，你收到的npm EBADENGINE警告是核心隐患！Firebase Tools 9.22.0当时并不完全支持Node.js 17，建议切换到Firebase官方支持的长期版本：

• 用nvm（Node版本管理器）安装Node.js 14或16
• 执行nvm install 16和nvm use 16切换版本
• 删除node_modules和package-lock.json后重新执行npm install，修复依赖兼容性

最后验证流程 #

1. 切换到兼容的Node.js版本
2. 执行npm run lint确认ESLint错误消失
3. 执行firebase deploy测试部署是否成功

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