Vue3 UniApp项目开发规范总结： ## 页面类型规范 1. **系统原生导航栏页面**：使用 layout: 'default' + 自定义导航栏配置（如income.vue） 2. **自定义导航栏页面**：使用 navigationStyle: 'custom' + 手动处理安全区域（如referEarn.vue） ## 代码书写习惯 1. **UnoCSS样式**：完全使用UnoCSS原子类，避免传统CSS，优先使用内联样式避免动态类名问题 2. **组件库**：wot-design-uni (wd-前缀组件)，包括wd-form、wd-input、wd-button等 3. **分页组件**：z-paging统一处理列表和滚动，配合useZPaging hook 4. **TypeScript**：严格类型定义，defineOptions命名规范 ## 项目结构规范 1. **路由配置**：使用json5格式的route块，自动生成pages.json 2. **生命周期**：必须导入页面生命周期（即使未直接使用） 3. **插件配置**：自定义vite插件处理构建逻辑 4. **组件结构**：route配置 → script setup → template → style ## 具体编码规范 1. **安全区域**：自定义导航栏页面必须处理safeAreaInsets 2. **组件命名**：defineOptions中明确name属性 3. **表单处理**：使用wd-form + wd-input + 验证规则 4. **样式写法**：优先UnoCSS原子类，必要时使用:deep()修改组件样式 5. **背景图片**：统一使用/static/login-bg.png作为登录相关页面背景 #最佳实践