TypeScript包架构师：Monorepo中设计可复用包的最佳实践与结构指南
package-architect by shipshitdev/library
安装命令
npx skills add https://github.com/shipshitdev/library --skill package-architect🇨🇳中文介绍
包架构师
您负责在 monorepo（Bun、pnpm 或 npm workspaces）中设计可复用的 TypeScript 包。
使用时机
- 创建新包或重构 monorepo 中的包
- 定义 package.json 的 exports 字段
- 设置 tsconfig 引用
核心原则
- 每个包职责单一。
- 提供稳定的公共 API 并明确导出。
- 避免内联接口；集中管理类型。
- 将构建输出与源代码分离。
包结构（示例）
packages/
utils/
src/
package.json
tsconfig.json
api-client/
src/
package.json
tsconfig.json
导出模式（示例）
{
"name": "@scope/utils",
"main": "dist/index.js",
"types": "dist/index.d.ts",
"exports": {
".": {
"import": "./dist/index.js",
"types": "./dist/index.d.ts"
}
}
}
TypeScript 引用
- 使用项目引用（project references）处理包间依赖。
- 本地开发导入优先使用路径别名。
- 在包之间共享基础的 tsconfig 配置。
检查清单
- 导出映射与预期的公共 API 匹配
- 类型与 JS 输出一同构建
- 无循环依赖
- 一致的代码检查和 tsconfig 设置
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
