TypeScript模块d.ts文件布局及JQuery接口合并引用问题

你现在遇到的核心问题是全局声明文件global.d.ts无法找到remote.ts中导出的IRemoteOptions接口——毕竟TypeScript需要明确的类型引用关系才能正确解析。针对你的ES5 + CommonJS编译目标，这里有两种可靠的解决方案：

方案一：使用三斜线引用指令 #

在global.d.ts的最顶部添加三斜线指令，直接指向remote.ts文件，让TypeScript自动加载其中的类型定义：

/// <reference path="./remote.ts" />

interface JQuery {
  remote(options?: IRemoteOptions): void; // 记得补全方法返回类型，比如void，避免类型缺失
}

注意：path里的路径要根据你的文件实际相对位置调整，确保能正确定位到remote.ts。这种方式适合简单项目结构，无需额外模块包裹。

方案二：使用类型导入 + 全局声明包裹 #

如果项目结构更复杂，或者更倾向于模块化的类型引用，可以用import type导入IRemoteOptions，再用declare global包裹JQuery的扩展，保证它依然是全局类型：

// global.d.ts
import type { IRemoteOptions } from './remote';

declare global {
  interface JQuery {
    remote(options?: IRemoteOptions): void;
  }
}

// 必须添加这一行，否则文件会被当作普通模块而非全局声明文件
export {};

这种方式更符合现代TypeScript的模块化规范，同时能确保JQuery的扩展在全局作用域生效。

额外注意事项 #

• 检查你的tsconfig.json，确保include数组包含remote.ts和global.d.ts，示例配置如下：

  {
    "compilerOptions": {
      "target": "ES5",
      "module": "CommonJS",
      // 其他配置项...
    },
    "include": ["src/**/*.ts", "src/**/*.d.ts"]
  }
  

• 确认remote.ts中的IRemoteOptions确实通过export导出，你当前的代码已经满足这个要求，无需调整。

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