如何无需添加依赖或引入完整包获取TypeScript包的模块命名空间类型？

你可以通过以下几种方式实现需求，无需安装@sdk/example主包，或仅安装类型依赖：

1. 安装单独的类型包（如果存在） #

很多npm包的类型定义会单独发布在@types命名空间下。你只需安装对应的类型开发依赖：

npm install --save-dev @types/sdk__example

（注：命名规则是把原包名的/替换为__，比如@sdk/example对应@types/sdk__example）

之后就可以仅导入类型，无需加载整个包：

import type * as Sdk from '@sdk/example';
// 直接使用 Sdk 类型即可

import type是TypeScript的语法，只会在类型检查阶段生效，编译后会被完全移除，不会引入任何包的运行时代码。

2. 手动声明模块类型 #

如果没有现成的类型包，可以自己在项目中声明@sdk/example的模块类型：

// 在项目的.d.ts文件中（比如src/types/sdk-example.d.ts）
declare module '@sdk/example' {
  // 根据包的API文档或预期结构定义类型
  export function init(config: { apiKey: string }): void;
  export interface User {
    id: string;
    name: string;
  }
  export const version: string;
  // 其他导出的类型或值
}

声明完成后，你同样可以用import type获取整个模块的类型：

import type * as Sdk from '@sdk/example';
type SdkType = typeof Sdk;

3. 直接引用类型（临时场景） #

如果知道包的类型文件结构，也可以直接通过类型引用语法获取，无需安装任何依赖：

type Sdk = typeof import('@sdk/example');

不过这种方式需要TypeScript能解析到包的类型定义，若未安装依赖，通常需要配合skipLibCheck配置项（在tsconfig.json中设置"skipLibCheck": true）来跳过缺失依赖的类型检查，但这可能会忽略其他类型问题，仅适合临时测试场景。

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