更新记录

1.0.1（2026-08-15） 下载此版本

更新商品管理

1.0.0（2026-08-15） 下载此版本

初始化提交

平台兼容性

云端兼容性

阿里云 腾讯云 支付宝云
√ √ ×

uni-app(4.36)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- √ √ √ √ × - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

其他

多语言 暗黑模式 宽屏模式
√ × √

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

鲜集 Market 后台管理系统安装教程

鲜集 Market 后台管理系统基于 uni-admin、uni-app Vue 3、uniCloud、uni-id 和 Element Plus 开发，用于管理“鲜集商城-线上超市”的业务数据、用户、角色、权限及运营配置。

本教程适用于 DCloud 插件市场项目：鲜集商城-线上超市 的后台管理系统。请在 HBuilderX 中打开后台项目目录后按本文完成安装、部署和运行。

环境要求

  • HBuilderX：建议使用 5.24 或更高版本
  • DCloud 账号：用于登录 HBuilderX、绑定和部署 uniCloud 服务空间
  • uniCloud 服务空间：当前项目使用 uniCloud-aliyun，建议选择阿里云服务空间
  • 浏览器：Chrome、Edge 或其他 Chromium 内核浏览器，用于运行后台 H5 管理端
  • Node.js：通常使用 HBuilderX 内置 Node.js 即可；如需命令行安装依赖，可使用本机 Node.js 18+

获取项目

从 DCloud 插件市场下载或导入项目后，解压到本地目录。后台管理系统需要作为一个独立 uni-app 项目打开，目录中应包含 manifest.json、pages.json、main.js、uniCloud-aliyun/ 等文件和目录。

安装前端依赖

后台项目依赖 element-plus 和 @element-plus/icons-vue。首次运行前，在后台项目根目录执行：

npm install

如果不使用命令行，也可以在 HBuilderX 中打开后台项目目录后，根据编辑器提示安装缺失依赖。

打开后台项目

  1. 启动 HBuilderX。
  2. 选择“文件 -> 打开目录”。
  3. 打开后台管理系统所在目录。
  4. 确认项目根目录下能看到 manifest.json、pages.json、main.js、uniCloud-aliyun/ 等文件和目录。

绑定 uniCloud 服务空间

  1. 在 HBuilderX 左侧项目树中找到 uniCloud-aliyun。
  2. 右键 uniCloud-aliyun，选择“关联云服务空间或项目”。
  3. 选择已有阿里云 uniCloud 服务空间，或按提示新建服务空间。
  4. 绑定完成后，确认 uniCloud-aliyun 目录不再提示未关联服务空间。

后台与“鲜集商城-线上超市”前端应用需要使用同一套 uniCloud 数据库。若你已经部署了商城前端，请为后台绑定同一个 uniCloud 服务空间，避免账号、商品、订单等数据分散到不同环境。

初始化数据库

项目数据库 schema 和初始化数据位于：

  • uniCloud-aliyun/database/*.schema.json
  • uniCloud-aliyun/database/*.init_data.json

初始化步骤：

  1. 在 HBuilderX 中展开 uniCloud-aliyun/database。
  2. 右键数据库目录或具体 schema 文件，上传所有数据库 schema。
  3. 右键对应的 *.init_data.json 文件，导入初始化数据。
  4. 重点确认以下初始化数据已导入：
    • uni-id-users.init_data.json
    • uni-id-roles.init_data.json
    • uni-id-permissions.init_data.json
    • opendb-admin-menus.init_data.json

这些数据用于后台登录、角色权限和菜单显示。如果登录成功但菜单为空，通常是菜单或权限初始化数据未导入。

部署云函数和公共模块

后台依赖 uniCloud 云函数、云对象及部分 uni_modules 内置云函数。首次安装需要部署：

  1. 右键 uniCloud-aliyun/cloudfunctions，选择“上传所有云函数、公共模块及actions”。
  2. 如只想按需部署，至少确认以下目录已上传：
    • uniCloud-aliyun/cloudfunctions/uni-portal
    • uniCloud-aliyun/cloudfunctions/uni-stat-*
    • uniCloud-aliyun/cloudfunctions/ext-storage-co
    • uniCloud-aliyun/cloudfunctions/uni-sms-co
    • uniCloud-aliyun/cloudfunctions/uni-upgrade-center
    • uni_modules/uni-id-pages/uniCloud/cloudfunctions/uni-id-co
    • uni_modules/uni-captcha/uniCloud/cloudfunctions/uni-captcha-co
  3. 如果 HBuilderX 提示需要上传公共模块，按提示一并上传。

修改云函数后，需要重新上传对应云函数才会在云端生效。

运行后台管理端

  1. 在 HBuilderX 中打开后台管理系统项目。
  2. 点击菜单“运行 -> 运行到浏览器 -> Chrome”或选择其他浏览器。
  3. 编译完成后访问 HBuilderX 自动打开的地址。
  4. 后台 H5 路由基础路径为 /admin/，如果手动部署到服务器，请确保站点路径与 manifest.json 中的 h5.router.base 保持一致。

登录后台

导入初始化数据后，可以使用初始化管理员账号登录。若初始化数据中未提供可用账号，请在 uniCloud 数据库的 uni-id-users 表中创建管理员用户，并为其绑定管理员角色。

登录后如出现无权限、菜单为空或页面 403，检查：

  • uni-id-users 是否存在管理员用户
  • uni-id-roles 是否存在管理员角色
  • uni-id-permissions 是否已导入权限数据
  • opendb-admin-menus 是否已导入菜单数据
  • 云函数 uni-id-co 是否已部署成功

发布部署

后台主要以 H5 方式部署：

  1. 在 HBuilderX 中选择“发行 -> 网站-H5手机版”。
  2. 按需配置发行目录。
  3. 将生成的 H5 静态文件上传到 Web 服务器。
  4. 如果部署路径不是 /admin/，需要同步修改 manifest.json 的 h5.router.base 后重新发行。

常见问题

依赖缺失或 Element Plus 报错

在后台项目根目录重新执行：

npm install

然后重新运行到浏览器。

无法连接 uniCloud

确认 HBuilderX 已登录 DCloud 账号，uniCloud-aliyun 已绑定服务空间，并且相关云函数已上传部署。

登录后没有菜单

通常是 opendb-admin-menus.init_data.json、uni-id-roles.init_data.json 或 uni-id-permissions.init_data.json 未导入，重新导入初始化数据后刷新后台。

修改云函数后本地看不到效果

云端调用以已部署版本为准。修改 uniCloud-aliyun/cloudfunctions 或 uni_modules/*/uniCloud/cloudfunctions 下的云函数后，需要重新上传部署。

技术栈

  • uni-app Vue 3
  • uni-admin
  • uniCloud 阿里云服务空间
  • uni-id 用户、角色、权限体系
  • Element Plus
  • @element-plus/icons-vue

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT License

Copyright (c) 2020 DCloud

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

评论列表 撰写评论 向官方投诉
加载更多...