TypeScript类型声明与模块导入：有效解决同级文件夹类型提示缺失

在TypeScript项目开发中，为同级文件夹下的JavaScript文件编写类型声明（通常在index.d.ts文件中）是一个常见问题。本文将详细讲解如何编写这些类型定义，确保在其他模块导入时获得准确的类型提示，从而提升开发效率。

假设我们有一个名为test的文件夹，其中包含index.js文件，该文件导出了一些函数和变量。我们希望在main.ts文件中导入test/index.js时，获得完整的类型提示，而不是仅看到import fnc这样的模糊信息。为此，我们需要在test文件夹下创建index.d.ts文件，并在其中声明index.js中导出内容的类型。

关键在于，index.d.ts文件的导出结构必须与index.js完全一致。例如，如果index.js包含如下代码：

Galileo TypeScript sdk

完整的Galileo AI平台 TypeScript/JS SDK 参考，用于评估、观察和保护 GenAI 应用。适用于构建 Node.js 或 TypeScript 项目。

下载

export function add(a, n = 1) {
    return a + n;
}

那么对应的index.d.ts文件应如下编写：

export function add(a: number, n?: number): number;

这行代码声明了add函数：接受一个数字类型参数a，一个可选的数字类型参数n（默认为1），并返回一个数字类型值。

在main.ts文件中，我们可以这样导入并使用add函数：

import { add } from './test';

// (a: number, n?: number | undefined) => number
type T = typeof add;

通过这种方式，TypeScript编译器根据index.d.ts中的类型声明，为add函数提供完整的类型提示，从而在开发过程中获得更准确的代码提示，减少错误并提高效率。这也能确保在其他项目中引用test模块时，IDE能够正确进行类型检查和代码补全。