TypeScript导入带版本号的Node.js模块问题求助

我之前也碰到过类似TS和Node.js模块导出兼容的坑，给你几个可行的解决思路：

一、调整导入语句，匹配Node.js的调用逻辑 #

你在Node.js里用const Package = require('package-name').V1;本质是先加载整个包，再取它的V1属性。对应到TS里，不要用解构导入，而是先导入整个模块命名空间，再获取V1：

// TS代码
import * as Package from 'package-name';
const V1Package = Package.V1;

// 之后就可以正常使用V1Package里的方法/属性了
V1Package.yourFunction();

这样编译后的JS代码会是：

const Package = require("package-name");
const V1Package = Package.V1;

完全和你原来Node.js里的写法逻辑一致，就能正确加载到V1的内容了。

如果想更简洁，也可以直接把V1重命名成你要的Package：

import * as PackageNS from 'package-name';
const Package = PackageNS.V1;

二、直接导入V1子模块（如果模块结构允许） #

如果你的package-name里V1是单独的文件（比如node_modules/package-name/V1.js），那可以跳过入口文件，直接导入这个子模块：

import * as Package from 'package-name/V1';

编译后的JS会直接require('package-name/V1')，也能避免入口文件的导出问题。

三、补充类型定义解决TS报错 #

TS里直接用.V1报错，大概率是因为模块没有提供对应的类型声明文件（@types/package-name）。你可以自己在项目里写一个类型声明文件（比如在src/types/package-name.d.ts）：

declare module 'package-name' {
  // 定义V1的结构，根据你的实际模块内容调整
  export const V1: {
    // 比如模块里有个fetchData函数
    fetchData: (id: number) => Promise<any>;
    // 还有个版本号属性
    version: string;
  };
}

写完后，确保TS能识别这个声明文件（可以在tsconfig.json里的include数组加上src/types/**/*.d.ts），这样TS就不会再报错了。

四、检查TS编译配置 #

最后确认下你的tsconfig.json里module选项设置的是CommonJS，因为Node.js默认用的是CommonJS模块系统，这样编译后的代码才能正确生成require语句：

{
  "compilerOptions": {
    "module": "CommonJS",
    "target": "ES6",
    "strict": true,
    "include": ["src/**/*", "src/types/**/*.d.ts"]
  }
}

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