yys-editor/docs/testing.md

# 测试指南

## 运行测试

项目已集成 Vitest 测试框架，支持以下测试命令：

```bash
# 运行所有测试（单次执行）
npm test

# 监听模式（文件变化时自动重新运行）
npm run test:watch

# 可视化界面运行测试
npm run test:ui

# 生成测试覆盖率报告
npm run test:coverage
```

## 测试文件结构

测试文件位于 `src/__tests__/` 目录：

- `schema.test.ts` - 数据结构和类型验证测试
- `useStore.test.ts` - Store 状态管理和数据操作测试

## 测试示例

### 1. Schema 数据结构测试

验证数据模型的正确性：
- 默认值检查
- 类型定义验证
- 式神/御魂数据结构

### 2. Store 状态管理测试

验证核心业务逻辑：
- 文件列表的增删改查
- 文件切换和重命名
- 数据导入导出
- localStorage 持久化

## 编写新测试

在 `src/__tests__/` 目录创建 `*.test.ts` 文件：

```typescript
import { describe, it, expect } from 'vitest'

describe('功能模块名称', () => {
  it('应该做某件事', () => {
    // 准备数据
    const input = { /* ... */ }

    // 执行操作
    const result = someFunction(input)

    // 验证结果
    expect(result).toBe(expectedValue)
  })
})
```

## 最佳实践

1. **数据验证优先** - 先测试数据层逻辑，确保核心功能正确
2. **独立测试** - 每个测试用例应该独立运行，不依赖其他测试
3. **清晰命名** - 测试描述应该清楚说明测试的内容和预期
4. **Mock 外部依赖** - 使用 `vi.mock()` 模拟外部模块，保持测试纯粹