如何在TypeScript模块中定义全局可用且无需导入的函数？

我明白你不想写重复的函数签名——那种先declare global再绑定到globalThis的样板代码确实有点繁琐。这里有几个更简洁的方案，能让你在模块文件里定义全局函数，不用重复写签名：

方案1：直接挂载+类型复用（仅需一次函数实现） #

在你的模块文件foo.ts里，先实现函数，再挂载到globalThis，最后通过类型扩展复用函数本身的类型，不用重新手写签名：

// foo.ts
// 先实现你的全局函数逻辑
export function foo() {
  console.log("全局函数foo被调用了");
}

// 把函数挂载到全局对象
globalThis.foo = foo;

// 扩展全局类型，让TS自动识别这个全局函数
declare global {
  interface Window {
    foo: typeof foo; // 直接复用已定义的函数类型，无需重复写签名
  }
}

这样在bar.ts里，你直接调用foo()就行，TS也能正确识别函数类型，全程只写了一次函数实现，没有冗余的签名代码。

方案2：带导入的模块场景适配 #

如果你的模块里必须导入其他依赖，但又想让函数保持全局可调用，同样可以用挂载+类型复用的思路，不用额外写重复签名：

// foo.ts
// 即使导入了其他模块，依然可以定义全局函数
import { formatLog } from "./utils";

// 实现函数逻辑
function foo() {
  formatLog("全局foo函数执行");
}

// 挂载到全局对象
globalThis.foo = foo;

// 扩展全局类型
declare global {
  interface Window {
    foo: typeof foo;
  }
}

// 可选：如果需要标记这是模块，加个空导出也不影响全局挂载
export {};

这个方案里，就算你导入了外部模块，只要把函数挂载到globalThis，再复用类型，依然能实现全局调用，且没有重复的签名代码。

方案3：全局类型文件统一管理 #

如果你的项目有多个全局函数，可以单独建一个global.d.ts文件统一声明类型，然后在对应模块里实现并挂载，进一步减少重复代码：

// global.d.ts
// 统一声明所有全局函数的类型
declare interface Window {
  foo: () => void;
  greet: (name: string) => void;
}

然后在foo.ts里实现并挂载：

// foo.ts
import { formatLog } from "./utils";

// 直接实现并挂载，不用再写类型
globalThis.foo = function() {
  formatLog("全局foo执行");
};

这种方式把类型声明集中管理，每个全局函数只需要写一次实现逻辑，非常适合多全局函数的项目。

额外注意 #

• Node.js环境下，把Window换成NodeJS.Global或者直接扩展globalThis的类型即可：

  declare global {
    var foo: typeof foo;
  }
  

• 确保tsconfig.json的include数组包含了你的类型文件（比如"include": ["src/**/*", "*.d.ts"]）。

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