tsconfig-paths TypeScript路径映射运行时加载工具

tsconfig 的路径映射功能,写起来舒服,用起来省事。但跑项目时,你遇到个坑:Node 不认这些 paths,直接报错找不到模块。嗯,这时候就得靠 tsconfig-paths 出场了。它能在运行时识别 tsconfig.json 里的 paths 配置,不用你再手动调整一堆 import 路径,挺省心的。

tsconfig-paths 支持两种用法,一个是直接在命令行跑,比如配合 ts-node 一起用;另一个是通过 API 调用,比较适合你自己搞 Node 脚本的时候集成进去。灵活性还不错,项目小能直接上,项目大也能拆着用。

说个实际点的场景,比如你 tsconfig.json 里写了这样一段:

{
  "compilerOptions": {
    "baseUrl": "./src",
    "paths": {
      "@utils/*": ["utils/*"]
    }
  }
}

如果没配置 tsconfig-paths,Node 就只会在 node_modules 里死找 @utils/xxx,根本不看你 tsconfig 的定义。而有了 tsconfig-paths,一切都顺了。

哦对了,Webpack 项目你用 ts-loaderbabel-loader TypeScript,那个场景不一定需要这个工具。但在纯 Node.js 项目里,是用 ts-node 的时候,它就管用。

如果你项目里有路径别名,又不想自己路径转换问题,可以考虑加上 tsconfig-paths。和 ts-node 一起配着用,开发体验能提升不少。

zip 文件大小:68.37KB