---
description: Flutter 组件开发
---

# Flutter 组件开发工作流

用于创建符合规范的 Flutter 组件。

## 执行步骤

1. **创建组件文件**
   - 添加标准文件头注释：创建时间、更新时间、名称、作用、上次更新内容
   - 使用 Cupertino 组件优先
   - 确保文件名使用小写加下划线

2. **定义组件接口**
   - 定义必要的参数
   - 使用命名参数
   - 添加参数注释

3. **实现组件逻辑**
   - 使用 StatefulWidget 处理状态
   - 实现响应式布局
   - 添加必要的空指针检查

4. **添加样式和主题**
   - 使用主题色和主题样式
   - 保持设计一致性
   - 支持动态主题

5. **添加交互功能**
   - 实现用户交互逻辑
   - 添加适当的反馈动画
   - 确保交互流畅

6. **添加调试支持**
   - 添加调试按钮/布局（如需要）
   - 提供测试数据接口
   - 添加调试日志

7. **编写组件注释**
   - 添加类注释说明作用
   - 为重要方法添加注释
   - 说明复杂逻辑

8. **测试组件**
   - 测试不同屏幕尺寸
   - 测试空值情况
   - 测试边界情况

9. **更新 CHANGELOG**
   - 记录组件创建
   - 说明功能变更
   - 更新版本号（如需要）