paipweb 项目

项目概述

• 项目名称: paipweb
• 框架: uni-app (Vue 3 + Vite)
• 状态管理: Pinia
• 样式预处理器: Sass
• 多语言支持: Vue I18n

环境要求

• Node.js 16.0 或更高版本
• npm 或 yarn 包管理器

安装依赖

# 使用 npm
npm install

# 或使用 yarn
yarn install

开发环境运行

H5 开发模式

npm run dev:h5

启动后访问 http://localhost:5173

自定义平台开发模式

npm run dev:custom

SSR 模式（H5）

npm run dev:h5:ssr

构建打包

H5 构建

npm run build:h5

构建产物位于 dist/build/h5 目录

自定义平台构建

npm run build:custom

SSR 构建（H5）

npm run build:h5:ssr

项目结构

paipweb/
├── src/                    # 源代码目录
│   ├── App.vue            # 应用入口
│   ├── main.js            # 主入口文件
│   ├── pages/             # 页面目录
│   │   ├── components/    # 组件目录
│   │   └── index/         # 首页
│   ├── stores/            # 状态管理
│   │   └── common.js      # 公共状态
│   ├── static/            # 静态资源
│   │   ├── fonts/         # 字体文件
│   │   ├── imgs/          # 图片资源
│   │   └── videos/        # 视频资源
│   └── uni.scss           # 全局样式
├── uni_modules/           # uni-app 模块
├── package.json           # 项目配置
├── vite.config.js         # Vite 配置
└── manifest.json          # 应用配置

测试指南

功能测试

1. 运行开发服务器：npm run dev:h5
2. 在浏览器中访问 http://localhost:5173
3. 测试各个页面的功能是否正常

打包测试

1. 执行构建命令：npm run build:h5
2. 检查构建产物是否完整
3. 在服务器上部署构建产物进行测试

常见问题

依赖安装失败

• 确保 Node.js 版本符合要求
• 尝试清除缓存：npm cache clean --force
• 使用淘宝镜像：npm config set registry https://registry.npmmirror.com

构建失败

• 检查 Node.js 和 npm 版本
• 确认所有依赖已正确安装
• 查看控制台错误信息进行排查

样式问题

• 检查 Sass 是否正确安装
• 确认 uni.scss 中的变量和混入是否正确导入

开发规范

• 使用 Vue 3 Composition API
• 组件命名采用 PascalCase
• 页面文件放在 src/pages 目录下
• 公共组件放在 src/pages/components 目录下
• 状态管理使用 Pinia