遇到 TS2349 报错，通常是因为你把一个非函数类型当作函数调用了，最直接的解决办法是检查导入方式或为变量补充可调用签名。

核心原因分析

TypeScript 要求调用表达式左侧的值必须具有“调用签名”（call signature）。如果你导入的是一个命名空间（namespace）或者普通对象，它们本身不可调用，只有内部的具体函数才可调用。

此外，如果第三方库缺少类型定义，TS 会将其推断为不含调用签名的对象类型，从而阻止调用。注意这里不是推断为 any，因为 any 类型通常是允许调用的，报错正是因为类型被锁定为具体的对象结构但缺少调用能力。

完整修复案例演示

以下是一个典型的错误场景与修复后的代码对比，展示如何从报错到解决的全过程。

❌ 报错代码：

// utils.ts
export const helper = (msg: string) => {
  console.log(msg);
};

// main.ts
import * as utils from './utils';
utils.helper('test'); // ✅ 正常
utils('test'); // ❌ TS2349: This expression is not callable.

✅ 修复代码：

如果确实需要直接调用导出项，需调整导出方式或导入方式。

// utils.ts
const helper = (msg: string) => {
  console.log(msg);
};
export default helper; // 改为默认导出

// main.ts
import helper from './utils'; // 改为默认导入
helper('test'); // ✅ 正常调用

类型补充的三种写法

如果是自己定义的变量，可通过类型断言或声明合并添加调用签名，以下是具体应用方式：

1. 类型断言（快速临时修复）

interface MyFunc {
  (arg: string): void;
}

const fn = someVariable as MyFunc;
fn('hello');

2. 变量声明时指定类型（推荐）

interface MyFunc {
  (arg: string): void;
}

const fn: MyFunc = (arg) => {
  console.log(arg);
};

3. 声明合并（针对已有变量）

如果变量已存在，可以通过接口合并扩展其类型。

interface ExistingVar {
  (arg: string): void;
  // 其他属性...
}

第三方库类型声明

对于缺少类型定义的第三方库，不要在业务代码中直接断言，建议在 .d.ts 文件中使用 declare module 进行全局扩展。

// types/global.d.ts
declare module 'my-unknown-lib' {
  const fn: (arg: string) => void;
  export default fn;
}

补充声明后，重启 TS 服务即可识别类型，无需在每个文件中重复断言。

验证与常见坑

验证方法：

在终端运行 tsc `--noEmit` 命令。如果终端没有输出 TS2349 相关错误，且 IDE 中的红色波浪线消失，说明类型补充正确。同时确保运行时没有因为导入路径变化导致 module not found 错误。

常见坑：

1. 盲目使用 any：将变量强制转为 any 虽然能消除报错，但会失去类型检查保护，不建议作为长期方案。
2. 混淆命名空间与函数：某些库同时导出命名空间和默认函数，导入时需区分 import * as 和 import。
3. React 组件调用：在 JSX 中误将组件当作函数调用（如 Component() 而非 <Component />）也可能触发类似错误。