zlwu
28232d5d46
- 🔥 完全重写 .cursor/cursorrules-mobile.md (940行) * 基于实际mobile工程Vue 3.4.21+uniapp+uview-plus架构 * 移除所有JeeSite相关内容，精准匹配实际项目 * 新增11个完整章节：技术栈、项目结构、页面开发、组件规范等 - 📚 创建完整规范文档 docs/开发文档/移动端开发规范总结.md (800+行) * 涵盖从项目架构到部署的全流程指导 * 提供可直接使用的页面和组件模板 * 包含现代CSS变量设计系统和用户体验优化 - 🔄 同步更新主配置文件 .cursorrules * 更新移动端技术栈描述 * 调整为Vue 3.4.21+uniapp+uview-plus 3.4.45架构 - 📝 完善变更记录 * 详细记录规范更新背景和技术价值 * 为后续维护提供完整历史记录 核心价值：解决规范与实际项目不匹配问题，为Cursor AI提供准确的移动端开发上下文，确保生成代码完全符合实际项目架构。
131 lines
4.0 KiB
Markdown
131 lines
4.0 KiB
Markdown
# 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%保留
|