我们使用 tsc 封 lib，通常会声明 "declaration": true，这是为了让，ts 自动生成 .d.ts ，这样只要我们在 package.json 里，声明 types 路径为生成好的 .d.ts 的 path , 智能提示类型检测就起作用了，这点也是 ts 相比 js+jsdoc/.d.ts 的爽点之一。

可是 esbuild 不支持输出 .d.ts, 见#95, 后来我依靠 esbuild-plugin-d.ts 暂时解决了这个问题。

不过，这个插件真的是慢 (毕竟 js 写的)，之前单单 buildAll 耗时只有 0.59s , 现在生成 .d.ts 11.64s , 一下子时间乘了 20 倍？！

同时很多 typescript 特性的缺失，也导致 ts 的功能无法充分发挥，比如 Only certain tsconfig.json fields are respected 章节中，提到的 However, esbuild currently only inspects the following fields in tsconfig.json files !

https://esbuild.github.io/content-types/#no-type-system

baseUrl
extends
importsNotUsedAsValues
jsxFactory
jsxFragmentFactory
paths
target
useDefineForClassFields

没了，All other fields will be ignored。

与其这样，我还不如用 rollup + @rollup/plugin-typescript 来构建这一套机制呢。

本人极菜的 jest 单元测试

前面说了，每个 repo 内部都有一个 test 文件夹，来进行单元测试。

那么问题来了根目录 jest.config.js 的 moduleNameMapper 如何配置？

如何让 vscode 插件 jest 和 jest runner 准确的运作，从而让我们点击 Debug 的时候，可以顺利的跑入 ts 源码里去？

import type {...} from '#types' 如何生效

有时候我们把 types 和 src 分开写放入 2 个文件夹，然后配置 tsconfig.json

{
  "compilerOptions":{
    "paths": {
      "#types/*": ["types/*"],
      "#types": ["types/index.d.ts"]
    }
  }
}

这种在 tsc 时候是没有问题的，但是 esbuild build 之后带来了寻址失败， import type { ... } from '#types' 原封不同的放在那里！

我应该给 esbuild-plugin-d.ts 提 bugs

这个问题，尝试修复一下
absWorkingDir 配置项无效，导致必须手动 resolve outDir 和 tsconfig.json ....

有些坑是生态上的，有些坑是个人能力不足导致的。

如果您也踩过这样的坑，欢迎传道受业解惑，我拜你为师。

结论

感觉这个思路失败了。目前版本的 esbuild 能够开发，但是不适合构建 lib

后续笔者学习 vue-next 的方式，使用 rollup + @rollup/plugin-typescript 来构建 lib 去了。

附录

simple-cloudbase-plugins

simple-cloudbase-router

目前废弃的分支 deprecated_dev

version:2.0.0

站点地图