# 测试指南

## 🎯 测试概览

本项目包含完整的测试套件，覆盖核心系统功能。

### 测试类型
- **属性测试**：使用随机数据验证通用属性（每个测试 50-100 次迭代）
- **单元测试**：验证特定功能和边界情况
- **集成测试**：测试系统间的交互

## 快速测试

### 运行所有测试（推荐）

1. 在 Godot 编辑器中打开 `tests/RunAllTests.tscn`
2. 按 **F6** 运行当前场景
3. 查看控制台输出，所有测试应该显示 ✅ PASSED
4. 测试完成后窗口会自动关闭

### 运行单个测试

**消息协议测试**：
- 打开 `tests/TestRunner.tscn`
- 按 F6
- 预期输出：
  ```
  [Property Test] Serialization Roundtrip
    Result: 100/100 passed
    ✅ PASSED
  [Unit Test] Message Creation
    ✅ PASSED
  [Unit Test] Message Validation
    ✅ PASSED
  ```

**游戏状态管理器测试**：
- 打开 `tests/TestGameStateManager.tscn`
- 按 F6
- 预期输出：
  ```
  [Unit Test] Initial State
    ✅ PASSED
  [Unit Test] State Transitions
    ✅ PASSED
  [Unit Test] State Change Signal
    ✅ PASSED
  [Unit Test] Data Persistence
    ✅ PASSED
  [Unit Test] Data Serialization
    ✅ PASSED
  ```

**角色数据测试**：
- 打开 `tests/TestCharacterData.tscn`
- 按 F6
- 预期输出：
  ```
  [Property Test] Character ID Uniqueness
    Result: 100 characters created, 100 unique IDs
    ✅ PASSED
  [Unit Test] Character Creation
    ✅ PASSED
  [Unit Test] Name Validation
    ✅ PASSED
  [Unit Test] Data Validation
    ✅ PASSED
  [Unit Test] Position Operations
    ✅ PASSED
  [Unit Test] Serialization Roundtrip
    ✅ PASSED
  ```

## 测试主游戏场景

运行主场景查看基础系统初始化：

1. 打开 `scenes/Main.tscn`
2. 按 **F5** 运行项目
3. 预期控制台输出：
   ```
   NetworkManager initialized
   GameStateManager initialized
   Initial state: LOGIN
   No saved player data found
   AI Town Game - Main scene loaded
   Godot version: 4.5.1-stable
   Initializing game systems...
   ```

## 测试覆盖

### 已测试的功能

✅ **消息协议** (test_message_protocol.gd)
- 属性测试：数据序列化往返（100次迭代）
- 单元测试：消息创建（所有类型）
- 单元测试：消息验证

✅ **游戏状态管理** (test_game_state_manager.gd)
- 单元测试：初始状态
- 单元测试：状态转换（LOGIN → CHARACTER_CREATION → IN_GAME → DISCONNECTED）
- 单元测试：状态变化信号
- 单元测试：数据持久化（保存/加载）
- 单元测试：JSON 序列化

✅ **角色数据模型** (test_character_data.gd)
- 属性测试：角色 ID 唯一性（100次迭代）
- 单元测试：角色创建
- 单元测试：名称验证（长度、空白检查）
- 单元测试：数据验证
- 单元测试：位置操作
- 单元测试：序列化往返

✅ **角色控制器** (test_character_controller.gd)
- 属性测试：碰撞检测（100次迭代）
- 属性测试：位置更新同步（100次迭代）
- 属性测试：角色移动能力（100次迭代）

✅ **输入处理器** (test_input_handler.gd)
- 属性测试：设备类型检测（100次迭代）
- 单元测试：键盘输入响应
- 单元测试：输入信号

### 测试统计

- **测试套件**: 5 个
- **属性测试**: 6 个（各 100 次迭代）
- **单元测试**: 18 个
- **总测试迭代**: 600+ 次

## 故障排除

### 如果测试失败

1. **检查控制台输出**：查找 "FAILED" 或 "Assertion failed" 消息
2. **查看错误详情**：失败的测试会显示具体的断言信息
3. **重新运行**：某些测试（如 ID 唯一性）使用随机数，可以重新运行确认

### 常见问题

**Q: 看不到测试输出？**
A: 确保 Godot 的输出面板是打开的（视图 → 输出）

**Q: 测试运行后立即关闭？**
A: 这是正常的，查看输出面板的历史记录

**Q: 某个测试一直失败？**
A: 检查该测试文件的代码，可能需要调整

## 下一步

测试通过后，你可以：

1. **游戏测试**：运行 `scenes/TestGameplay.tscn` 测试游戏功能
2. **启动服务器**：`cd server && yarn dev` 启动多人服务器
3. **继续开发**：参考 `.kiro/specs/godot-ai-town-game/tasks.md`

## 测试文件位置

```
tests/
├── RunAllTests.tscn              # 运行所有测试
├── RunPropertyTests.tscn         # 运行属性测试
├── TestGameplay.tscn             # 游戏功能测试
├── test_*.gd                     # 测试脚本
└── TEST_GUIDE.md                 # 本文档
```