TypeScript智能感知不显示Console对象 console.log失效问题

• 写完数据库拉取的API调用逻辑后，console.log 调用直接报错无法正常执行
• TypeScript智能提示列表里搜不到原生Console对象
• 类型检查提示console上不存在log属性/方法

本质是当前作用域存在和全局console重名的标识符，覆盖了原生全局console对象。绝大多数情况都是写API逻辑时要么自己声明了同名变量，要么从引入的数据库SDK、工具依赖里导入了同名导出项。TS识别到的console是这个无对应类型、没有log方法的自定义/导入值，自然不会弹出原生Console的智能提示，调用log方法也会报类型错误。

• 全局搜索当前文件内的console关键词，先排查手写的API逻辑里有没有const console = xxx、let console = xxx、function console() {}这类声明，有的话直接把这个自定义变量/函数重命名，不要和全局console撞名。
• 检查文件顶部的import语句，确认是否从数据库相关依赖里导入了名为console的导出项：

  // 错误写法：导入的同名console直接覆盖全局对象
  import { console } from 'xxx-db-client'
  
  // 修复方式1：给导入项起别名避开重名
  import { console as dbDebugConsole } from 'xxx-db-client'
  // 修复方式2：如果是手滑添加的无用导入，直接删掉该行即可
  

• 排查API逻辑的函数内部、条件判断/循环等代码块内部有没有局部声明console，哪怕是未赋值的声明也会因为变量提升覆盖全局对象：

  const fetchDbList = async () => {
    // 哪怕是下面这行未赋值的声明，也会让整个函数作用域内的console指向这个局部变量
    let console
    const data = await db.query('SELECT * FROM user_list')
    console.log(data) // 此处必然报错，因为此时console是局部声明的undefined
  }
  // 修复：删掉局部的console声明，或者给局部变量更换不冲突的名称
  

• 以上排查完成后如果仍存在类型报错，打开项目根目录的tsconfig.json检查配置：
  • 前端浏览器项目：确认lib配置项中包含"DOM"，确保浏览器原生对象的类型声明被正确加载
  • Node.js后端项目：确认已安装@types/node依赖，Node原生全局对象的类型声明都维护在这个包中

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