如何从TypeScript项目B动态导入TS文件至项目A？

你提到的场景完全可行，核心要解决TS语法解析、模块路径识别和类型支持三个问题，以下是适配CommonJS规范的几种方案：

方案一：编译后作为依赖引用（推荐生产使用） #

这是最规范的插件架构实现方式，适配项目A发布为NPM包的场景：

1. 配置项目B的编译输出
   修改项目B的tsconfig.json，确保编译为CommonJS模块并生成类型声明文件：

   {
     "compilerOptions": {
       "module": "CommonJS",
       "outDir": "./dist",
       "declaration": true, // 生成.d.ts提供类型提示
       "target": "ES2019"
     },
     "include": ["plugin.ts"]
   }
   

   同时在项目B的package.json中指定入口和类型文件路径：

   {
     "main": "./dist/plugin.js",
     "types": "./dist/plugin.d.ts",
     "scripts": {
       "build": "tsc"
     }
   }
   

   执行npm run build编译项目B。

2. 在项目A中引用项目B

   • 开发阶段：在项目A的package.json中添加本地依赖，方便调试：

     "dependencies": {
       "project-b": "file:../path/to/projectB"
     }
     

     执行npm install完成依赖安装。
   • 生产发布：将项目B发布到NPM，然后在项目A的package.json中声明正常的NPM依赖：

     "dependencies": {
       "project-b": "^1.0.0"
     }
     

3. 在项目A中动态导入
   在async函数中使用动态导入即可，同时自动获得类型支持：

   async function loadPlugin() {
     const plugin = await import('project-b');
     // 此处可直接使用plugin的导出内容，且有完整类型提示
     plugin.run();
   }
   loadPlugin();
   

方案二：实时编译TS文件（适合开发调试） #

如果不想每次修改项目B都重新编译，可以用ts-node实时解析TS文件，仅推荐开发阶段使用：

1. 安装依赖
   在项目A中安装ts-node和typescript：

   npm install ts-node typescript --save-dev
   

2. 动态导入时注册TS编译钩子
   先加载ts-node的编译逻辑，再导入项目B的TS文件：

   async function loadExternalPlugin() {
     // 注册TS编译处理
     require('ts-node').register({
       compilerOptions: { module: 'CommonJS' }
     });
     // 直接导入项目B的TS文件
     const plugin = require('c:/projectB/plugin.ts');
     plugin.run();
   }
   loadExternalPlugin();
   

   或者用动态导入的方式：

   async function loadExternalPlugin() {
     await import('ts-node/register');
     const plugin = await import('c:/projectB/plugin.ts');
     plugin.run();
   }
   

   注意：这种方式性能较低，生产环境不建议使用；类型支持需要在项目A的tsconfig.json中添加项目B的路径到include数组：

   {
     "include": ["src/**/*", "c:/projectB/**/*"]
   }
   

方案三：自定义模块路径（临时调试用，不推荐生产） #

修改项目A的tsconfig.json，将项目B的路径加入解析范围：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@project-b/*": ["c:/projectB/*"]
    }
  },
  "include": ["src/**/*", "c:/projectB/**/*"]
}

之后可以用别名导入，但仍需配合方案二的实时编译，否则Node.js无法识别TS文件：

async function loadPlugin() {
  await import('ts-node/register');
  const plugin = await import('@project-b/plugin.ts');
}

该方案仅适合本地调试，因为发布后其他用户环境中不存在c:/projectB路径，无法正常运行。

关键注意事项 #

• 两个项目均为CommonJS规范，动态导入必须在async函数中使用await，或通过.then()处理异步逻辑
• Node.js无法直接解析TS文件，必须编译为JS或通过工具实时转译
• 类型支持依赖.d.ts文件，项目B必须开启declaration编译选项
• 发布项目A时，必须将项目B作为正式依赖声明在package.json中，不能使用本地文件路径

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