VSCode IntelliSense无法合并自定义类型与已有模块的自动补全

现有文件内容 #

1. export.js #

function myFunction1() {
    //something
}

function myFunction2() {
    //something
}

function myFunction3() {
    //something
}


module.exports = {
    myFunction1: myFunction1,
    myFunction2: myFunction2,
}

2. 自定义.d.ts声明文件 #

//I need to use external libraries that don't
//have an easy way of importing functions, hence a decleration File
declare module test {
    export function myFunction4(a: string): string;
    export function myFuntcion5(a: number): number;
}

3. 主文件使用方式 #

let test = require('./export.js');

test.myFunction1(); //期望能补全到myFunction5

问题现象 #

未导入export.js时，IntelliSense能显示myFunction4和myFunction5；但导入该文件后，仅能看到myFunction1和myFunction2，希望合并两者实现完整的自动补全。

要合并JS模块的实际导出和.d.ts的扩展声明，核心是让.d.ts直接针对./export.js这个具体模块路径做类型声明，而非独立的test模块。具体实现有两种方式：

方式1：基于原模块类型扩展 #

// 针对./export.js模块做扩展声明
declare module './export.js' {
    // 导入原模块的基础类型
    import OriginalModule = require('./export.js');

    // 定义扩展后的模块接口，继承原类型并添加新函数
    export interface ExtendedModule extends OriginalModule {
        myFunction4(a: string): string;
        myFunction5(a: number): number; // 注意修正原声明中的拼写错误：myFuntcion5 → myFunction5
    }

    // 导出扩展后的类型
    const module: ExtendedModule;
    export = module;
}

方式2：直接声明完整模块类型 #

如果不需要依赖原模块的自动推导类型，可以直接手动声明所有导出项：

declare module './export.js' {
    export function myFunction1(): void;
    export function myFunction2(): void;
    export function myFunction4(a: string): string;
    export function myFunction5(a: number): number;
}

注意事项 #

• 将修改后的.d.ts文件放在export.js同目录下，或项目的类型声明目录（如@types）中，确保编辑器能识别到
• 修正原声明中的拼写错误myFuntcion5，避免补全失效

原理：当使用require('./export.js')导入模块时，TypeScript会优先匹配针对该具体路径的类型声明，而非独立的test模块。通过直接绑定目标模块的声明，就能将原有JS导出的函数和自定义扩展的函数合并，实现完整的IntelliSense提示。

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