快速使用
以下是 mini-ui 组件库快速使用指南,可直接用于文档站点:
# mi-ui 快速上手
- 获取源码
git clone https://github.com/miren521/mi-ui.git
将仓库中的 packages 目录复制到你 UniApp 项目的根目录下。
- 配置 easycom
在 pages.json 中添加(UniApp 默认已开启 easycom,只需补充自定义规则):
{
"easycom": {
"autoscan": true,
"custom": {
"^m-(.*)": "@/packages/m-1/m-1.vue"
}
}
}
⚠️ 修改 pages.json 后需重新编译项目才能生效。
- 直接使用
无需 import / 注册,在任意 .vue 文件中按 <m-组件名> 格式书写即可:
<template>
<m-button type="primary">按钮</m-button>
<m-tag color="red">标签</m-tag>
</template>
组件会自动解析到 @/packages/m-button/m-button.vue、@/packages/m-tag/m-tag.vue。
- 高度自定义
由于是本地源码引用,你可以直接修改 packages/m-xxx/m-xxx.vue 中的模板、样式和逻辑,改动即时生效,完全掌控每一行代码。
注意事项
| 事项 | 说明 |
|---|---|
| 目录结构 | 每个组件必须遵循 packages/m-xxx/m-xxx.vue 命名规范 |
| 新增组件 | 新建文件夹 + 同名 .vue 文件即可,easycom 自动识别 |
| HBuilderX | 若智能提示缺失,重启 IDE 或手动刷新 easycom 缓存 |
| 版本更新 | 重新 git pull 并覆盖 packages 目录,注意备份本地修改 |
上次更新: 2026/09/10, 17:17:02