skillhub-179-ts-library
wehub-skill-sync
158 行
2.8 KiB
Markdown
158 行
2.8 KiB
Markdown
# 项目配置
|
||
|
||
## 单包
|
||
|
||
```bash
|
||
# 克隆启动模板
|
||
cp -r ~/templates/antfu/starter-ts my-lib
|
||
cd my-lib && rm -rf .git && git init
|
||
pnpm install
|
||
```
|
||
|
||
或者手动配置：
|
||
|
||
```bash
|
||
mkdir my-lib && cd my-lib
|
||
pnpm init
|
||
pnpm add -D typescript tsdown vitest eslint @antfu/eslint-config
|
||
```
|
||
|
||
### 目录结构
|
||
|
||
```
|
||
my-lib/
|
||
├── src/
|
||
│ ├── index.ts # 主入口
|
||
│ └── types.ts # 类型定义
|
||
├── test/
|
||
│ └── index.test.ts
|
||
├── dist/ # 构建输出（已 gitignore）
|
||
├── package.json
|
||
├── tsconfig.json
|
||
├── tsdown.config.ts
|
||
├── eslint.config.ts
|
||
└── vitest.config.ts
|
||
```
|
||
|
||
## 单体仓库
|
||
|
||
```bash
|
||
cp -r ~/templates/antfu/starter-monorepo my-monorepo
|
||
cd my-monorepo && rm -rf .git && git init
|
||
pnpm install
|
||
```
|
||
|
||
### 结构
|
||
|
||
```
|
||
my-monorepo/
|
||
├── packages/
|
||
│ ├── core/
|
||
│ │ ├── src/
|
||
│ │ ├── package.json
|
||
│ │ └── tsdown.config.ts
|
||
│ └── cli/
|
||
│ ├── src/
|
||
│ └── package.json
|
||
├── playground/ # 集成测试
|
||
├── pnpm-workspace.yaml
|
||
├── package.json # 根级脚本、devDeps
|
||
├── tsconfig.json # 基础配置
|
||
└── eslint.config.ts
|
||
```
|
||
|
||
### pnpm-workspace.yaml
|
||
|
||
```yaml
|
||
packages:
|
||
- packages/*
|
||
- playground
|
||
|
||
catalogs:
|
||
build:
|
||
tsdown: ^0.15.0
|
||
unbuild: ^3.0.0
|
||
lint:
|
||
eslint: ^9.0.0
|
||
'@antfu/eslint-config': ^4.0.0
|
||
test:
|
||
vitest: ^3.0.0
|
||
types:
|
||
typescript: ^5.7.0
|
||
```
|
||
|
||
## pnpm Catalogs
|
||
|
||
按用途组织依赖项（来自 antfu 的博客文章）：
|
||
|
||
| 类别 | 内容 |
|
||
| ------- | ---------------------------------- |
|
||
| build | tsdown, unbuild, rollup 插件 |
|
||
| lint | eslint, @antfu/eslint-config |
|
||
| test | vitest, @vue/test-utils |
|
||
| types | typescript, @types/\* |
|
||
| prod | 运行时依赖：consola, defu, pathe |
|
||
|
||
### 使用 Catalogs
|
||
|
||
```json
|
||
{
|
||
"devDependencies": {
|
||
"tsdown": "catalog:build",
|
||
"eslint": "catalog:lint",
|
||
"vitest": "catalog:test",
|
||
"typescript": "catalog:types"
|
||
}
|
||
}
|
||
```
|
||
|
||
## ESLint 配置
|
||
|
||
```bash
|
||
pnpm add -D eslint @antfu/eslint-config
|
||
```
|
||
|
||
```typescript
|
||
// eslint.config.ts
|
||
import antfu from '@antfu/eslint-config'
|
||
|
||
export default antfu({
|
||
type: 'lib',
|
||
pnpm: true,
|
||
formatters: true,
|
||
})
|
||
```
|
||
|
||
## Git Hooks
|
||
|
||
```bash
|
||
pnpm add -D simple-git-hooks lint-staged
|
||
```
|
||
|
||
```json
|
||
{
|
||
"simple-git-hooks": { "pre-commit": "pnpm lint-staged" },
|
||
"lint-staged": { "*": "eslint --fix" },
|
||
"scripts": { "prepare": "simple-git-hooks" }
|
||
}
|
||
```
|
||
|
||
添加后运行 `pnpm prepare`。
|
||
|
||
## 脚本
|
||
|
||
```json
|
||
{
|
||
"scripts": {
|
||
"build": "tsdown",
|
||
"dev": "tsdown --watch",
|
||
"lint": "eslint .",
|
||
"lint:fix": "eslint . --fix",
|
||
"typecheck": "tsc --noEmit",
|
||
"test": "vitest",
|
||
"release": "bumpp",
|
||
"prepublishOnly": "pnpm build"
|
||
}
|
||
}
|
||
```
|