如何在TypeScript项目中使用封装于命名空间的npm包接口？

你的报错根源是这个npm包的类型采用**TypeScript全局命名空间（namespace）**声明，而非标准ES模块导出格式，常规import语法无法识别这种全局命名空间下的接口。

正确使用方式 #

方式一：直接使用全局命名空间 #

只要TypeScript能扫描到该类型文件，就可以直接通过命名空间路径访问接口：

1. 先确认tsconfig.json配置，确保类型文件被加载：
   • 检查include数组，添加"node_modules/xserver-code/**/*.d.ts"；
   • 或者在typeRoots数组中加入"./node_modules/xserver-code/dist/application"，让TypeScript扫描该目录下的类型文件。
2. 定义类时直接调用命名空间中的接口：

class MyServer implements Xserver.Application.XServerInterface {
    serve(): void {
        // 写入你的实现逻辑
        console.log('服务已启动');
    }
}

方式二：封装成模块导入（可选） #

如果习惯用import语法，可以在项目内写一个包装文件，把全局命名空间的接口转为模块导出：

1. 新建文件（比如xserver-wrapper.ts）：

// 引用全局命名空间的接口
declare global {
    namespace Xserver.Application {
        interface XServerInterface {
            serve(): void;
        }
    }
}

// 将接口导出为模块成员
export type XServerInterface = Xserver.Application.XServerInterface;

2. 在需要使用的文件中导入：

import { XServerInterface } from './xserver-wrapper';

class MyServer implements XServerInterface {
    serve(): void {
        // 实现逻辑
    }
}

内容的提问来源于stack exchange，提问作者Professor of programming