uni-app 端开发规范
页面配置规范
pages.json 作为 uni-app 的核心配置文件,承载着整个应用的页面路由、导航栏样式、底部TabBar等重要配置。在配置过程中需要严格遵循以下原则:
路径规范 :页面路径必须以"app/pages/"开头,确保与目录结构保持一致
国际化支持 :所有导航栏标题必须使用语言包键名,格式为"%pages.xxx.xxx%",严禁硬编码文本
平台差异化处理 :合理使用条件编译,针对不同平台设置差异化样式
登录权限控制 :需要登录的页面必须显式声明"needLogin": true
页面组件开发标准
每个页面组件都应该遵循统一的结构和命名规范,确保代码的可读性和可维护性
组件设计原则
组件是构建用户界面的基本单元,良好的组件设计能够提高代码复用性和可维护性。在开发过程中需要遵循以下原则:
单一职责原则 :每个组件应该只负责一个功能,避免组件过于复杂
props向下传递 :数据通过props自上而下传递,避免逆向数据流
事件向上传递 :子组件通过emit向父组件传递事件
样式隔离 :组件样式必须使用scoped,避免样式污染
Pinia Store设计原则
状态管理是大型应用的核心,良好的状态设计能够确保数据流的清晰和可预测性:
状态单一化 :避免在多个地方存储相同的状态
状态最小化 :只存储必要的状态,派生状态通过计算属性获取
异步操作集中化 :所有的异步操作都放到actions中处理
状态持久化 :重要状态需要持久化到本地存储
WindiCSS使用规范
WindiCSS作为原子化CSS框架,能够极大提高样式开发效率,但需要遵循一定的使用规范:
优先使用原子类 :能用原子类实现的样式不要使用自定义CSS
响应式设计 :使用断点前缀实现响应式布局
主题色彩 :使用CSS变量确保主题一致性
性能优化 :避免过度嵌套,控制样式复杂度
