# Cursor Rules - 移动端开发规范 (Vue 3 + uniapp + uview-plus)
## 适用范围
- **项目目录**: `mobile/` (现代化智慧校园移动应用)
- **开发语言**: JavaScript (Vue 3)
- **平台支持**: H5、小程序、APP、鸿蒙
- **UI 框架**: uView UI 2.x (uview-plus 3.4.45)
---
# 智慧校园移动端开发规范
## 1. 🎯 技术栈规范
### 核心技术
- **基础框架**: uni-app + Vue 3.4.21
- **UI 组件库**: uview-plus 3.4.45 (Vue 3 版本)
- **开发语言**: JavaScript (ES6+)
- **国际化**: vue-i18n 9.1.9 (Vue 3 版本)
- **样式预处理**: Sass 1.89.2
- **构建工具**: Vite 5.2.8
- **代码规范**: ESLint 9.30.1
### 版本信息
```json
{
"name": "uni-preset-vue",
"version": "0.0.0",
"dependencies": {
"@dcloudio/uni-app": "3.0.0-4060620250520001",
"uview-plus": "^3.4.45",
"vue": "^3.4.21",
"vue-i18n": "^9.1.9"
},
"devDependencies": {
"sass": "^1.89.2",
"vite": "5.2.8",
"eslint": "^9.30.1"
}
}
```
## 2. 📁 项目结构规范
### 目录结构
```
mobile/
├── src/ # 源码目录
│ ├── components/ # 通用组件
│ │ ├── NavBar.vue # 导航栏组件
│ │ ├── Card.vue # 卡片组件
│ │ ├── ServiceItem.vue # 服务项组件
│ │ ├── StatCard.vue # 统计卡片组件
│ │ └── GridLayout.vue # 网格布局组件
│ ├── pages/ # 页面文件
│ │ ├── index/ # 首页
│ │ │ └── index.vue # 首页内容
│ │ ├── workbench/ # 办公中心
│ │ │ └── index.vue # 办公中心内容
│ │ └── profile/ # 我的页面
│ │ └── index.vue # 个人中心内容
│ ├── utils/ # 工具类
│ │ ├── request.js # 网络请求工具
│ │ ├── sse.js # SSE实时数据工具
│ │ ├── device.js # 设备检测工具
│ │ ├── animations.js # 动画工具
│ │ ├── gestures.js # 手势识别工具
│ │ └── accessibility.js # 无障碍访问工具
│ ├── static/ # 静态资源
│ │ ├── tabbar/ # 底部导航图标
│ │ └── fonts/ # 字体文件
│ ├── App.vue # 应用入口
│ ├── main.js # 项目入口
│ ├── pages.json # 页面配置
│ ├── manifest.json # 应用配置
│ └── uni.scss # 全局样式
├── package.json # 项目配置
├── vite.config.js # Vite构建配置
├── eslint.config.cjs # ESLint配置
└── README.md # 项目说明
```
## 3. 🎨 页面开发规范
### 页面模板标准
```vue
```
### 页面样式规范
#### 使用 CSS 变量系统
```scss
// 主题色彩变量
:root {
--primary-color: rgb(93, 135, 255);
--primary-light: rgba(93, 135, 255, 0.1);
--primary-dark: rgb(73, 115, 235);
--success-color: #52c41a;
--warning-color: #faad14;
--error-color: #ff4d4f;
--text-primary: #262626;
--text-secondary: #595959;
--text-disabled: #bfbfbf;
--border-color: #f0f0f0;
--background-color: #f8f9fa;
--white: #ffffff;
--shadow-light: 0 2px 8px rgba(0, 0, 0, 0.06);
--shadow-medium: 0 4px 16px rgba(0, 0, 0, 0.12);
--radius-small: 4px;
--radius-medium: 8px;
--radius-large: 12px;
--spacing-xs: 4px;
--spacing-sm: 8px;
--spacing-md: 16px;
--spacing-lg: 24px;
--spacing-xl: 32px;
--transition-fast: 0.2s ease;
--transition-medium: 0.3s ease;
--font-size-xs: 12px;
--font-size-sm: 14px;
--font-size-md: 16px;
--font-size-lg: 18px;
--font-size-xl: 20px;
}
```
#### 工具类规范
```scss
/* 布局工具类 */
.flex {
display: flex;
}
.flex-center {
display: flex;
align-items: center;
justify-content: center;
}
.flex-between {
display: flex;
align-items: center;
justify-content: space-between;
}
.flex-column {
display: flex;
flex-direction: column;
}
/* 文本工具类 */
.text-center {
text-align: center;
}
.text-primary {
color: var(--primary-color);
}
.text-secondary {
color: var(--text-secondary);
}
/* 背景工具类 */
.bg-primary {
background-color: var(--primary-color);
}
.bg-white {
background-color: var(--white);
}
/* 间距工具类 */
.mt-sm {
margin-top: var(--spacing-sm);
}
.mt-md {
margin-top: var(--spacing-md);
}
.mt-lg {
margin-top: var(--spacing-lg);
}
.p-sm {
padding: var(--spacing-sm);
}
.p-md {
padding: var(--spacing-md);
}
.p-lg {
padding: var(--spacing-lg);
}
```
## 4. 🧩 组件开发规范
### 自定义组件模板
```vue
```
### 组件命名规范
- **文件命名**: 使用 PascalCase (如: `NavBar.vue`, `ServiceItem.vue`)
- **组件名称**: 使用 PascalCase (如: `NavBar`, `ServiceItem`)
- **引用方式**: 支持驼峰和短横线 (如: `` 或 ``)
## 5. 🎨 图标使用规范 (SVG Data URI 方案)
### 背景说明
由于 uview-plus 的 u-icon 组件在某些环境下存在显示异常(显示为横线),项目采用 **SVG Data URI** 方案实现图标系统,确保跨平台兼容性和显示稳定性。
### 核心优势
- ✅ **零外部依赖**: 图标直接嵌入 CSS,无需字体文件或 CDN
- ✅ **100%兼容性**: 支持 H5、小程序、App、HarmonyOS 等所有平台
- ✅ **加载稳定**: 无 404 错误,无网络请求,性能优异
- ✅ **样式灵活**: 通过 CSS filter 实现颜色自定义
- ✅ **维护简单**: 基于 Material Design,图标清晰美观
### 图标配置文件
**位置**: `mobile/src/static/fonts/iconfont.css`
```css
.iconfont {
display: inline-block;
width: 16px;
height: 16px;
background-size: contain;
background-repeat: no-repeat;
background-position: center;
}
/* 用户图标 */
.icon-user {
background-image: url("data:image/svg+xml;charset=utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='currentColor'%3E%3Cpath d='M12 12c2.21 0 4-1.79 4-4s-1.79-4-4-4-4 1.79-4 4 1.79 4 4 4zm0 2c-2.67 0-8 1.34-8 4v2h16v-2c0-2.66-5.33-4-8-4z'/%3E%3C/svg%3E");
}
/* 密码锁图标 */
.icon-lock {
background-image: url("data:image/svg+xml;charset=utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='currentColor'%3E%3Cpath d='M18 8h-1V6c0-2.76-2.24-5-5-5S7 3.24 7 6v2H6c-1.1 0-2 .9-2 2v10c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2V10c0-1.1-.9-2-2-2zM9 6c0-1.66 1.34-3 3-3s3 1.34 3 3v2H9V6z'/%3E%3C/svg%3E");
}
/* 更多图标... */
```
### 全局引入配置
**位置**: `mobile/src/main.js`
```javascript
import { createSSRApp } from 'vue';
import App from './App.vue';
import uviewPlus from 'uview-plus';
// 导入 uview-plus 样式
import 'uview-plus/index.scss';
// 导入 iconfont 样式 (必需)
import '@/static/fonts/iconfont.css';
export function createApp() {
const app = createSSRApp(App);
app.use(uviewPlus);
return { app };
}
```
### 可用图标列表
#### 基础图标 (4 个)
- `icon-user` - 用户图标
- `icon-lock` - 密码锁图标
- `icon-eye` - 眼睛图标(显示密码)
- `icon-eye-close` - 眼睛关闭图标(隐藏密码)
#### 操作图标 (5 个)
- `icon-login` - 登录图标
- `icon-search` - 搜索图标
- `icon-add` - 添加图标
- `icon-check` - 确认图标
- `icon-close` - 关闭图标
#### 导航图标 (4 个)
- `icon-home` - 首页图标
- `icon-message` - 消息图标
- `icon-setting` - 设置图标
- `icon-arrow-right` - 右箭头图标
#### 联系图标 (2 个)
- `icon-phone` - 电话图标
- `icon-mail` - 邮箱图标
### 标准使用方法
#### 基础用法
```vue
```
#### 自定义样式
```vue
```
### 常用颜色 Filter 值
```css
/* 主题色 #5d87ff */
.icon-primary {
filter: brightness(0) saturate(100%) invert(38%) sepia(87%) saturate(6400%) hue-rotate(225deg)
brightness(104%) contrast(104%);
}
/* 成功色 #52c41a */
.icon-success {
filter: brightness(0) saturate(100%) invert(56%) sepia(91%) saturate(2063%) hue-rotate(88deg)
brightness(118%) contrast(84%);
}
/* 警告色 #faad14 */
.icon-warning {
filter: brightness(0) saturate(100%) invert(75%) sepia(95%) saturate(1978%) hue-rotate(7deg)
brightness(108%) contrast(92%);
}
/* 错误色 #ff4d4f */
.icon-error {
filter: brightness(0) saturate(100%) invert(27%) sepia(91%) saturate(2870%) hue-rotate(353deg)
brightness(104%) contrast(97%);
}
/* 灰色 #8c8c8c */
.icon-gray {
filter: brightness(0) saturate(100%) invert(55%) sepia(0%) saturate(0%) hue-rotate(174deg)
brightness(94%) contrast(86%);
}
```
### 扩展新图标
当需要添加新图标时,按以下步骤操作:
1. **获取 SVG 源码**:从 Material Design Icons 或其他图标库获取 SVG
2. **URL 编码**:将 SVG 代码进行 URL 编码
3. **添加 CSS 类**:在 `iconfont.css` 中添加新的图标类
```css
/* 新图标示例 */
.icon-new {
background-image: url('data:image/svg+xml;charset=utf8,{URL编码的SVG代码}');
}
```
### 强制性规范要求
1. **禁止使用 uview-plus 的 u-icon 组件**:统一使用 SVG Data URI 方案
2. **图标类名规范**:必须使用 `icon-` 前缀 + 语义化名称
3. **基础类必须添加**:所有图标元素必须包含 `iconfont` 基础类
4. **大小自定义**:通过 `width` 和 `height` 属性设置图标大小
5. **颜色自定义**:通过 CSS `filter` 属性实现颜色变换
### 性能优化建议
1. **CSS 压缩**:生产环境下压缩 `iconfont.css` 文件
2. **按需加载**:仅引入项目实际使用的图标
3. **缓存策略**:CSS 文件设置长期缓存
4. **图标复用**:相同功能使用统一图标,避免重复定义
## 6. 🌐 API 接口规范
### 网络请求工具 (utils/request.js)
```javascript
// API请求配置
const baseURL =
process.env.NODE_ENV === 'development'
? 'http://localhost:3000/api'
: 'https://your-api-domain.com/api';
// 统一请求方法
export const request = (options) => {
return new Promise((resolve, reject) => {
uni.request({
url: baseURL + options.url,
method: options.method || 'GET',
data: options.data || {},
header: {
'Content-Type': 'application/json',
Authorization: getToken(),
...options.header,
},
success: (res) => {
if (res.statusCode === 200) {
resolve(res.data);
} else {
reject(res);
}
},
fail: (error) => {
reject(error);
},
});
});
};
// 获取token
function getToken() {
try {
const token = uni.getStorageSync('token');
return token ? `Bearer ${token}` : '';
} catch (e) {
return '';
}
}
// API方法封装
export const api = {
// 用户登录
login: (data) =>
request({
url: '/auth/login',
method: 'POST',
data: {
tenantId: data.tenantId || '000000',
username: data.username,
password: data.password,
clientId: data.clientId || 'e5cd7e4891bf95d1d19206ce24a7b32e',
grantType: data.grantType || 'password',
},
header: {
isToken: false,
isEncrypt: true,
repeatSubmit: false,
},
}),
// 获取用户信息
getUserInfo: () =>
request({
url: '/system/user/getInfo',
method: 'GET',
}),
// 获取租户列表
getTenantList: (isToken = false) =>
request({
url: '/auth/tenant/list',
method: 'GET',
header: {
isToken: isToken,
},
}),
// 注销登录
logout: () =>
request({
url: '/auth/logout',
method: 'POST',
}),
};
// 用户信息缓存工具
export const userStorage = {
// 保存登录信息
saveLoginInfo: (loginResult, userInfo) => {
try {
// 保存token
uni.setStorageSync('access_token', loginResult.access_token);
// 保存用户信息
if (userInfo) {
uni.setStorageSync('userInfo', JSON.stringify(userInfo));
}
// 保存登录状态
uni.setStorageSync('isLoggedIn', true);
console.log('用户登录信息已保存');
} catch (e) {
console.error('保存登录信息失败:', e);
}
},
// 获取用户信息
getUserInfo: () => {
try {
const userInfo = uni.getStorageSync('userInfo');
return userInfo ? JSON.parse(userInfo) : null;
} catch (e) {
console.error('获取用户信息失败:', e);
return null;
}
},
// 获取token
getToken: () => {
try {
return uni.getStorageSync('access_token') || '';
} catch (e) {
return '';
}
},
// 检查登录状态
isLoggedIn: () => {
try {
const isLoggedIn = uni.getStorageSync('isLoggedIn');
const token = uni.getStorageSync('access_token');
return !!(isLoggedIn && token);
} catch (e) {
return false;
}
},
// 清除登录信息
clearLoginInfo: () => {
try {
uni.removeStorageSync('access_token');
uni.removeStorageSync('userInfo');
uni.removeStorageSync('isLoggedIn');
console.log('用户登录信息已清除');
} catch (e) {
console.error('清除登录信息失败:', e);
}
},
};
```
### 数据缓存规范
```javascript
// 数据缓存工具 (utils/request.js)
export const storage = {
// 设置缓存
set: (key, value, expire) => {
try {
const data = {
value,
timestamp: Date.now(),
expire: expire ? Date.now() + expire * 1000 : null,
};
uni.setStorageSync(key, JSON.stringify(data));
} catch (e) {
console.error('缓存设置失败:', e);
}
},
// 获取缓存
get: (key) => {
try {
const data = uni.getStorageSync(key);
if (!data) return null;
const parsed = JSON.parse(data);
// 检查是否过期
if (parsed.expire && Date.now() > parsed.expire) {
uni.removeStorageSync(key);
return null;
}
return parsed.value;
} catch (e) {
console.error('缓存获取失败:', e);
return null;
}
},
// 删除缓存
remove: (key) => {
try {
uni.removeStorageSync(key);
} catch (e) {
console.error('缓存删除失败:', e);
}
},
// 清空缓存
clear: () => {
try {
uni.clearStorageSync();
} catch (e) {
console.error('缓存清空失败:', e);
}
},
};
```
## 7. 🔐 登录状态管理规范
### 登录页面开发规范
#### 登录页面模板 (pages/login/index.vue)
```vue
{{ loading ? '登录中...' : '登录' }}
```
### 登录状态验证规范
#### 全局登录验证
每个需要登录的页面都必须在 `onLoad` 生命周期中检查登录状态:
```javascript
// 页面登录状态检查模板
export default {
onLoad() {
this.checkLoginStatus();
},
methods: {
checkLoginStatus() {
if (!userStorage.isLoggedIn()) {
uni.reLaunch({
url: '/pages/login/index',
});
return false;
}
return true;
},
loadUserInfo() {
const userInfo = userStorage.getUserInfo();
if (userInfo && userInfo.user) {
this.userInfo.name = userInfo.user.nickName || userInfo.user.userName || '用户';
// 根据需要设置其他用户信息
}
},
},
};
```
#### 退出登录处理
```javascript
// 退出登录标准流程
handleLogout() {
uni.showModal({
title: '确认退出',
content: '确定要退出登录吗?',
success: (res) => {
if (res.confirm) {
uni.showLoading({ title: '正在退出...' });
// 清除登录信息
userStorage.clearLoginInfo();
setTimeout(() => {
uni.hideLoading();
uni.showToast({
title: '已退出登录',
icon: 'success'
});
// 跳转到登录页面
setTimeout(() => {
uni.reLaunch({
url: '/pages/login/index'
});
}, 500);
}, 1000);
}
},
});
}
```
### 应用入口配置
#### pages.json 登录页配置
```json
{
"pages": [
{
"path": "pages/login/index",
"style": {
"navigationBarTitleText": "登录",
"navigationStyle": "custom",
"navigationBarBackgroundColor": "transparent",
"backgroundColor": "transparent"
}
},
{
"path": "pages/index/index",
"style": {
"navigationBarTitleText": "首页",
"navigationStyle": "custom"
}
}
// 其他页面...
],
"globalStyle": {
"navigationBarTextStyle": "white",
"navigationBarTitleText": "智慧校园",
"navigationBarBackgroundColor": "rgb(93, 135, 255)",
"backgroundColor": "#f8f9fa"
}
}
```
### 登录状态管理最佳实践
#### 1. 安全性原则
```javascript
// 敏感信息处理
const securityUtils = {
// 敏感数据加密存储
setSecureStorage: (key, value) => {
try {
// 简单的Base64编码,生产环境建议使用更强的加密
const encoded = btoa(JSON.stringify(value));
uni.setStorageSync(key, encoded);
} catch (e) {
console.error('安全存储失败:', e);
}
},
// 敏感数据解密读取
getSecureStorage: (key) => {
try {
const encoded = uni.getStorageSync(key);
if (!encoded) return null;
return JSON.parse(atob(encoded));
} catch (e) {
console.error('安全读取失败:', e);
return null;
}
},
};
```
#### 2. 自动登录检查
```javascript
// App.vue 中的全局登录状态检查
export default {
onLaunch() {
this.checkAutoLogin();
},
methods: {
checkAutoLogin() {
const isLoggedIn = userStorage.isLoggedIn();
const currentPages = getCurrentPages();
const currentRoute = currentPages[currentPages.length - 1]?.route;
// 如果未登录且不在登录页,跳转到登录页
if (!isLoggedIn && currentRoute !== 'pages/login/index') {
uni.reLaunch({
url: '/pages/login/index',
});
}
},
},
};
```
#### 3. Token 过期处理
```javascript
// 请求拦截器中的Token过期处理
export const request = (options) => {
return new Promise((resolve, reject) => {
uni.request({
// 请求配置...
success: (res) => {
if (res.statusCode === 401) {
// Token过期处理
userStorage.clearLoginInfo();
uni.showToast({
title: '登录已过期,请重新登录',
icon: 'none',
});
setTimeout(() => {
uni.reLaunch({
url: '/pages/login/index',
});
}, 2000);
return;
}
// 其他响应处理...
},
});
});
};
```
## 8. 📱 页面配置规范
### pages.json 配置
```json
{
"pages": [
{
"path": "pages/index/index",
"style": {
"navigationBarTitleText": "首页",
"navigationStyle": "custom"
}
},
{
"path": "pages/workbench/index",
"style": {
"navigationBarTitleText": "办公中心",
"navigationStyle": "custom"
}
},
{
"path": "pages/profile/index",
"style": {
"navigationBarTitleText": "我的",
"navigationStyle": "custom"
}
}
],
"globalStyle": {
"navigationBarTextStyle": "white",
"navigationBarTitleText": "智慧校园",
"navigationBarBackgroundColor": "rgb(93, 135, 255)",
"backgroundColor": "#f8f9fa"
},
"tabBar": {
"color": "#999999",
"selectedColor": "rgb(93, 135, 255)",
"borderStyle": "white",
"backgroundColor": "#ffffff",
"height": "60px",
"fontSize": "12px",
"iconWidth": "22px",
"iconHeight": "22px",
"list": [
{
"pagePath": "pages/index/index",
"text": "首页",
"iconPath": "static/tabbar/home.svg",
"selectedIconPath": "static/tabbar/home-active.svg"
},
{
"pagePath": "pages/workbench/index",
"text": "办公中心",
"iconPath": "static/tabbar/workbench.svg",
"selectedIconPath": "static/tabbar/workbench-active.svg"
},
{
"pagePath": "pages/profile/index",
"text": "我的",
"iconPath": "static/tabbar/profile.svg",
"selectedIconPath": "static/tabbar/profile-active.svg"
}
]
}
}
```
### manifest.json 配置
```json
{
"name": "智慧校园",
"appid": "",
"description": "基于Vue3+uniapp的智慧校园移动应用",
"versionName": "1.0.0",
"versionCode": "100",
"transformPx": false,
"vueVersion": "3",
"app-plus": {
"usingComponents": true,
"nvueStyleCompiler": "uni-app",
"compilerVersion": 3,
"splashscreen": {
"alwaysShowBeforeRender": true,
"waiting": true,
"autoclose": true,
"delay": 0
},
"modules": {},
"distribute": {
"android": {
"permissions": [
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
""
]
},
"ios": {},
"sdkConfigs": {}
}
},
"quickapp": {},
"mp-weixin": {
"appid": "",
"setting": {
"urlCheck": false
},
"usingComponents": true
},
"mp-alipay": {
"usingComponents": true
},
"mp-baidu": {
"usingComponents": true
},
"mp-toutiao": {
"usingComponents": true
},
"uniStatistics": {
"enable": false
}
}
```
## 9. 🎭 用户体验规范
### 交互设计规范
#### 动画效果使用
```javascript
// utils/animations.js - 动画工具
export const animationUtils = {
// 淡入动画
fadeIn: (element) => {
element.style.animation = 'fadeIn 0.3s ease';
},
// 滑入动画
slideUp: (element) => {
element.style.animation = 'slideUp 0.3s ease';
},
// 缩放动画
scale: (element) => {
element.style.animation = 'scale 0.2s ease';
},
}
// 在页面中使用
methods: {
handleItemClick() {
// 触觉反馈
uni.vibrateShort();
// 视觉反馈
// 处理点击逻辑
}
}
```
#### 手势操作支持
```javascript
// utils/gestures.js - 手势识别
export const gestureManager = {
// 初始化手势
init: (element, callbacks) => {
let startX, startY, startTime;
element.addEventListener('touchstart', (e) => {
startX = e.touches[0].clientX;
startY = e.touches[0].clientY;
startTime = Date.now();
});
element.addEventListener('touchend', (e) => {
const endX = e.changedTouches[0].clientX;
const endY = e.changedTouches[0].clientY;
const endTime = Date.now();
// 判断手势类型
const deltaX = endX - startX;
const deltaY = endY - startY;
const deltaTime = endTime - startTime;
if (Math.abs(deltaX) > Math.abs(deltaY) && Math.abs(deltaX) > 50) {
if (deltaX > 0) {
callbacks.swipeRight && callbacks.swipeRight();
} else {
callbacks.swipeLeft && callbacks.swipeLeft();
}
}
});
},
};
```
### 无障碍访问规范
```javascript
// utils/accessibility.js - 无障碍访问工具
export const accessibilityUtils = {
// 设置焦点
setFocus: (element) => {
element.focus();
},
// 添加ARIA标签
addAriaLabel: (element, label) => {
element.setAttribute('aria-label', label);
},
// 键盘导航支持
enableKeyboardNavigation: (container) => {
container.addEventListener('keydown', (e) => {
switch (e.key) {
case 'Tab':
// Tab导航逻辑
break;
case 'Enter':
case ' ':
// 激活元素
e.target.click();
break;
case 'Escape':
// 取消操作
break;
}
});
},
};
```
## 10. 🚀 性能优化规范
### 代码优化
#### 组件懒加载
```javascript
// 页面中使用懒加载
export default {
components: {
// 懒加载组件
LazyComponent: () => import('@/components/LazyComponent.vue'),
},
};
```
#### 图片优化
```vue
```
### 网络优化
#### 请求缓存策略
```javascript
// 智能缓存策略
export const cacheStrategy = {
// 短期缓存 (5分钟)
short: 5 * 60,
// 中期缓存 (30分钟)
medium: 30 * 60,
// 长期缓存 (24小时)
long: 24 * 60 * 60,
};
// API调用示例
export const api = {
getUserInfo: () => {
const cacheKey = 'userInfo';
const cached = storage.get(cacheKey);
if (cached) {
return Promise.resolve(cached);
}
return request({
url: '/user/info',
}).then((data) => {
storage.set(cacheKey, data, cacheStrategy.medium);
return data;
});
},
};
```
## 11. 🛠️ 开发工具配置
### Vite 配置 (vite.config.js)
```javascript
import { defineConfig } from 'vite';
import uni from '@dcloudio/vite-plugin-uni';
export default defineConfig({
plugins: [uni()],
server: {
port: 3000,
open: true,
},
build: {
// 生产环境优化
minify: 'terser',
terserOptions: {
compress: {
drop_console: true,
drop_debugger: true,
},
},
},
});
```
### ESLint 配置 (eslint.config.cjs)
```javascript
module.exports = [
{
files: ['src/**/*.{js,vue}'],
languageOptions: {
ecmaVersion: 2022,
sourceType: 'module',
},
rules: {
indent: ['error', 2],
quotes: ['error', 'single'],
semi: ['error', 'never'],
'no-console': 'warn',
'no-debugger': 'error',
},
},
];
```
## 12. 📋 开发命令规范
### 常用命令
```bash
# 安装依赖
npm install
# H5开发
npm run dev:h5
# 微信小程序开发
npm run dev:mp-weixin
# App开发
npm run dev:app
# 构建H5
npm run build:h5
# 构建微信小程序
npm run build:mp-weixin
# 代码检查
npm run lint
# 代码自动修复
npm run lint:fix
```
## 13. ✅ 最佳实践总结
### 代码规范
1. **文件组织**: 按功能模块组织文件结构
2. **组件复用**: 提取通用组件,避免重复代码
3. **样式管理**: 使用 CSS 变量系统,便于主题切换
4. **性能优化**: 合理使用缓存和懒加载
5. **用户体验**: 添加加载状态、错误处理和无障碍支持
### 开发流程
1. **需求分析** → 确定页面结构和功能
2. **组件设计** → 拆分可复用组件
3. **页面开发** → 按模板编写页面代码
4. **样式调优** → 使用统一的设计规范
5. **功能测试** → 多平台测试确保兼容性
6. **性能优化** → 优化加载速度和用户体验
### 质量保证
1. **代码审查**: 确保代码符合规范
2. **功能测试**: 确保所有功能正常工作
3. **兼容性测试**: 确保多平台兼容
4. **性能测试**: 确保应用性能满足要求
5. **用户体验测试**: 确保交互流畅自然
---
## 🎯 总结
本规范基于实际的 Vue 3 + uniapp + uview-plus 项目制定,提供了完整的现代化移动端开发流程。
**✨ 技术特色**:
- ✅ **Vue 3**: 现代化的响应式框架
- ✅ **uview-plus**: 成熟的 Vue 3 UI 组件库
- ✅ **现代 CSS**: 使用 CSS 变量的设计系统
- ✅ **无障碍访问**: 完整的无障碍访问支持
- ✅ **智能缓存**: 高效的数据缓存策略
- ✅ **用户体验**: 流畅的动画和手势支持
**🎨 设计理念**:
- 现代简约的视觉设计
- 一致的交互体验
- 响应式适配
- 无障碍友好
**📱 平台支持**:
- H5 (Web)
- 微信小程序
- 支付宝小程序
- iOS/Android App
- 鸿蒙 App
遵循本规范能够确保代码质量、提升开发效率,并为用户提供优秀的移动端体验。
---
**📝 维护**: 移动端开发规范文档
**🔄 更新**: 2025-01-03 (新增登录状态管理规范)
**📁 文件**: .cursor/cursorrules-mobile.md