Cursor 通用编码规则

代码风格

• 使用 2 空格缩进
• 行尾加分号
• 使用单引号
• 变量命名使用 camelCase
• 常量使用 UPPER_SNAKE_CASE

注释规范

• 函数/方法必须写 JSDoc 注释
• 复杂逻辑需要行内注释
• TODO 标记必须附带责任人

架构要求

• 遵循单一职责原则
• 组件文件不超过 200 行
• 工具函数抽离到独立的 utils 文件

错误处理

• 所有异步操作必须 try-catch
• 错误信息必须包含上下文
• 用户可见错误使用中文提示

性能

• 避免不必要的 re-render
• 大型列表使用虚拟滚动
• API 请求需要缓存策略