hzdyjs/.cursor

Cursor 规范文件拆分说明

🎯 拆分目的

为了提升 Cursor 编辑器的运行效率和规范管理的便利性，我们将原本的大型.cursorrules文件（2359 行）拆分为多个专门的规范文件。

📁 文件结构

.cursor/
├── README.md                    # 本说明文件
├── cursorrules-docs.md          # 文档管理规范
├── cursorrules-frontend.md      # 前端开发规范 (Vue 3 + TypeScript)
├── cursorrules-backend.md       # 后端开发规范 (Spring Boot + MyBatis)
├── cursorrules-mobile.md        # 移动端开发规范 (Vue 3 + uniapp + uview-plus)
└── cursorrules-api-test.md      # API测试和登录方法

📋 文件说明

1. cursorrules-docs.md

• 项目文档管理规范
• 文档目录组织结构
• 强制性文档同步更新规则
• 变更记录管理规范
• 业务模块文档管理
• API 文档管理规范
• 测试文档管理规范

2. cursorrules-frontend.md

• Web 前端开发规范
• Vue 3 + TypeScript 技术栈
• Art Design Pro UI 规范
• 组件开发标准
• API 接口定义规范
• 状态管理和路由配置
• 项目架构和性能优化

3. cursorrules-backend.md

• 后端开发规范
• Spring Boot 技术栈
• 数据库设计规范（强制性）
• API 接口规范（强制性）
• 菜单界面和权限配置
• 标准代码模板

4. cursorrules-mobile.md

• 移动端开发规范
• Vue 3 + uni-app + uview-plus 技术栈
• 现代化智慧校园移动应用架构
• 页面和组件开发规范（CSS变量设计系统）
• API 对接规范（智能缓存策略）
• 用户体验优化（动画、手势、无障碍访问）
• 多端发布和性能优化

5. cursorrules-api-test.md

• API 测试和登录方法
• AES+RSA 双重加密登录
• API 测试最佳实践
• 自动化测试脚本
• 性能测试方法

🔄 使用方式

Cursor 编辑器自动加载

Cursor 编辑器会自动扫描项目中的规范文件，包括.cursor/目录下的所有规范文件。拆分后的文件仍然能够被 Cursor 正常识别和使用。

手动引用

如果需要明确引用特定规范，可以在对话中提及：

• "请按照前端开发规范..."
• "遵循后端 API 接口规范..."
• "参考文档管理规范..."

模块化开发

现在可以针对不同技术栈进行专门的开发：

• 前端开发人员主要关注 cursorrules-frontend.md
• 后端开发人员主要关注 cursorrules-backend.md
• 移动端开发人员主要关注 cursorrules-mobile.md
• 测试人员主要关注 cursorrules-api-test.md

🚀 性能优势

1. 加载速度提升: 每个文件体积更小，加载更快
2. 内容精准: 根据开发场景加载相关规范
3. 维护便利: 不同技术栈的规范独立维护
4. 版本管理: 便于跟踪不同模块的规范变更

🔧 维护说明

规范更新原则

1. 技术栈专门化: 每个文件只包含相关技术栈的规范
2. 内容完整性: 确保每个文件内容自包含，可独立使用
3. 交叉引用: 在需要时明确说明与其他规范文件的关联

文件同步

• 当项目架构或通用规范发生变化时，需要同步更新相关文件
• 重要的跨模块规范变更需要在多个文件中保持一致

📝 更新记录

• 2025-07-01: 完成.cursorrules 文件拆分，创建 5 个专门规范文件
• 拆分原因: 提升 Cursor 运行效率，便于规范管理
• 文件保留: 所有原有内容完整保留，无任何删除

🎯 使用建议

1. 日常开发: Cursor 会自动应用相关规范
2. 规范查阅: 可直接打开对应的规范文件查看详细内容
3. 团队协作: 不同角色的开发者可专注相关规范文件
4. 规范更新: 按技术栈分别维护和更新规范内容

---

维护人员: wuzilong
创建时间: 2025-07-01 16:15:00
文件总数: 5 个专门规范文件
原文件行数: 2359 行
内容完整性: 100%保留