能否用TypeScript配置的paths风格抽象Node模块导入以应对包拆分？

你的需求完全合理——通过抽象导入路径来减少后续包拆分时的代码修改量，这在大型私有模块维护中非常常见。下面是几种经过实践验证的方案：

方案1：利用TypeScript的paths配置（TS项目首选） #

你已经熟悉本地导入的paths配置，其实它完全可以用来映射私有Node模块的导入。具体做法是在你的项目根目录的tsconfig.json里，把原本的模块导入拆分成更细的路径映射：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "my-package/thing1": ["node_modules/my-package/src/thing1"],
      "my-package/thing2": ["node_modules/my-package/src/thing2"]
    }
  }
}

然后把项目里的导入改成：

import { thing1 } from 'my-package/thing1';
import { thing2 } from 'my-package/thing2';

等你要把thing2拆分到my-package2时，只需要修改paths里的映射：

"paths": {
  "my-package/thing1": ["node_modules/my-package/src/thing1"],
  "my-package/thing2": ["node_modules/my-package2/src/thing2"]
}

这样所有项目代码都不用改动，只改一处配置就行。注意：Node本身不识别paths，所以需要配合ts-node、tsc编译（编译时会自动替换路径），或者webpack/Vite等打包工具的别名配置同步映射。

方案2：使用package.json的exports字段（原生Node支持，无依赖） #

这是更推荐的原生方案，不需要依赖TypeScript配置，Node 12+就支持。你可以在**私有模块my-package**的package.json里，用exports字段定义细粒度的导出路径：

{
  "name": "my-package",
  "exports": {
    "./thing1": "./src/thing1.ts",
    "./thing2": "./src/thing2.ts"
  }
}

项目里的导入同样改成按子路径导入：

import { thing1 } from 'my-package/thing1';
import { thing2 } from 'my-package/thing2';

当你要拆分thing2到my-package2时，只需要在my-package的package.json里做个过渡映射：

{
  "name": "my-package",
  "exports": {
    "./thing1": "./src/thing1.ts",
    "./thing2": "my-package2/thing2" // 直接指向新包的子路径
  },
  "dependencies": {
    "my-package2": "^1.0.0" // 把新包作为依赖引入
  }
}

这样项目代码完全不用改，更新my-package版本后，Node会自动把my-package/thing2的导入转发到my-package2。等过渡完成后，再逐步把项目里的导入改成my-package2/thing2即可。

方案3：使用module-alias包（JS/TS通用，灵活适配） #

如果你的项目是纯JS，或者不想用TS配置/原生exports，可以用module-alias这个轻量工具。

首先安装依赖：

npm install module-alias --save

然后在项目根目录的package.json里配置别名：

{
  "_moduleAliases": {
    "my-package/thing1": "./node_modules/my-package/src/thing1",
    "my-package/thing2": "./node_modules/my-package/src/thing2"
  }
}

最后在项目入口文件顶部注册别名：

// JS项目
require('module-alias/register');

// TS项目
import 'module-alias/register';

后续拆分时，只需要修改_moduleAliases里的映射路径，和paths配置的效果一样。

额外建议 #

如果你的私有模块是在Monorepo（比如用pnpm workspaces、Lerna）里管理的，结合workspaces和上面的方案会更顺畅——可以直接映射到Monorepo里的本地包路径，不用等到发布到私有仓库就能测试拆分后的效果。

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