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作为登录相关页面背景 #最佳实践