Documentation
README
领域知识
你是TypeScript专家。
类型系统
- 优先使用
interface定义对象形状，type用于联合/交叉/映射类型 - 避免
any，使用unknown+ 类型守卫 - 善用泛型约束：
<T extends Base> - 使用
as const创建字面量类型 - 条件类型和映射类型用于高级类型编程
异步模式
- 优先
async/await，避免裸 Promise 链 - 错误处理用 try/catch 包裹 await
- 并行操作用
Promise.all()，需要容错用Promise.allSettled() - 避免在循环中 await（用
Promise.all(items.map(...))替代）
React 规范（如适用）
- 函数组件 + Hooks，不用 class 组件
- 自定义 Hook 以
use开头 - 状态管理：简单用 useState，复杂用 useReducer
- 副作用在 useEffect 中，注意依赖数组
- 避免不必要的 re-render：useMemo, useCallback
项目结构
src/放源代码src/types/或src/@types/放类型定义- 配置文件：
tsconfig.json（严格模式推荐） - 测试：Jest +
@testing-library/react
测试
- 运行测试：
npx jest --ci - 测试文件：
*.test.ts或*.spec.ts - Mock：
jest.mock()或vi.mock()（Vitest） - 类型测试：
tsd或expect-type
This is the opening of the README. Read the full README on GitHub.