更新记录

1.2.3（2026-03-27） 下载此版本

变更（文档与元数据）

• package.json：version 1.2.3，与插件市场发版及本文 §3 一致。
• 文档与元数据实质内容同 1.2.2（见下节：readme 全量组件表、OSS Logo、repository、changelog、联系页等）；本版本为发版号递增，无新增代码或文档条目。

1.2.2（2026-03-27） 下载此版本

Logo 完善回复显示

1.2.1（2026-03-27） 下载此版本

变更（文档与插件市场）

• readme.md：按插件市场常见结构整理（说明、特点、文档、链接、预览、安装、快速上手、使用方法、组件列表、版权）；使用方法与示例工程一致：createSSRApp、pages.json · easycom 规则、全局样式引入；说明 app.use(mUnix) 与 uni.$m / mount$m() 的关系；按需引入 libs/utils.uts 与 components/m-tools/Request.uts（并注明依赖宿主 @/common/config）；可选 多语言（initI18n）前提。
• readme.md · 预览：增加 4 张运行效果示意图（HTTPS 图床，表格排版）。
• package.json：repository 为合法 Git 地址；dcloudext.npmurl 为插件市场详情页链接。
• changelog.md：§1.1 DCloud 插件市场、Logo 与 logo.png 说明已与上架信息一致。
• 示例工程 · 联系我们（pages_Me/contact/contact.uvue）：增加 插件市场 入口链接。

平台兼容性

uni-app x(4.87)

其他

mUnix

面向 uni-app x 的基础 UI 与工具库

说明

mUnix（包目录 uni_modules/m-unix，插件 ID m-unix）是面向 uni-app x 的自研 UI 方案：脚本为 UTS，页面与组件为 uvue，提供 *`m-组件**、**m-tools工具**与 **mUi` 主题配置，可在 App / 微信小程序 / H5** 等端按需接入。

版本号、变更记录与联系方式以包内 package.json、changelog.md 为准，与 DCloud 插件市场 展示同步维护。

特点

• 专为 uni-app x：组件与工具均以 .uvue + UTS 编写，类型约束清晰。
• 独立命名：组件统一 m- 前缀，避免与生态其它库冲突。
• 按需使用：支持 easycom 自动引入，也可单独 import 组件或 libs。
• 主题可配：通过 mUi / setMUiConfig 与业务侧配置对齐主色与资源。
• 多端适配：安全区与常见端差异已在组件侧考虑（具体以各组件说明为准）。

文档

• 在线文档（站点）：https://mmsadmin.cn/m-unix/README.html
• 更新日志（权威）：本目录 changelog.md（与 package.json 的 version 一致）
• 源码与 Issue：https://gitee.com/mmsAdmin/m-unix

链接

• DCloud 插件市场 · m-unix（亦支持 ?id=m-unix）
• 组件说明站点首页
• Gitee 开源仓库
• 问题反馈（Gitee Issues）

预览

在线文档中含组件说明与示例要点；本仓库示例工程 pages_demo 下为各组件演示页，可在 HBuilderX 中运行目标端查看效果。

以下为运行效果示意（多端以实际为准）：

预览 1	预览 2

安装

uni-app 插件市场链接 —— https://ext.dcloud.net.cn/plugin?name=m-unix

通过 HBuilderX 导入插件或使用已有工程：将 uni_modules/m-unix 置于项目内，HBuilderX 会自动识别 uni_modules 规范插件（建议使用 3.1.0 及以上版本 HBuilderX）。

快速上手

1. 在 pages.json 中配置 easycom（规则见下「easycom」；与示例工程一致时可复制即用）。
2. 在 main.uts 中用 createSSRApp 创建应用并执行 app.use(mUnix)（会注册全局组件并挂载 uni.$m / this.$m，一般不必再调 mount$m()）。
3. 在 App.uvue 中 @import index.scss（主题与工具类样式，建议保留）。

详见下文「使用方法」。

使用方法

easycom（pages.json）

在 pages.json 根级增加 easycom，使 m-组件名 无需手写 import 即可解析到包内路径：

{
  "easycom": {
    "autoscan": true,
    "custom": {
      "^m-(.*)": "@/uni_modules/m-unix/components/m-$1/m-$1.uvue"
    }
  }
}

配置后模板中可直接使用：

<m-button type="primary">确定</m-button>

全局安装（main.uts）

uni-app x 入口需使用 createSSRApp（来自 vue），并 export function createApp() 返回 { app }，与框架约定一致：

import App from './App.uvue'
import { createSSRApp } from 'vue'
import mUnix from '@/uni_modules/m-unix'

export function createApp() {
  const app = createSSRApp(App)
  app.use(mUnix)
  return {
    app
  }
}

说明：

• app.use(mUnix) 会执行包内 install：批量注册 *`m-** 全局组件，并将工具合并到 **uni.$m** 与 **Vue.config.globalProperties.$m`**。
• mUnix.mount$m() 仅向 uni.$m 注入工具；在已 app.use(mUnix) 的场景下通常重复，仅当不使用 app.use、又需要 uni.$m 时可单独调用。

可选：多语言（initI18n）

若使用示例工程中的 initI18n()，需在 main.uts 于创建应用前调用，且项目中存在 locale/index.uts 所依赖的 *`@/locale/.json** 等资源（路径以你工程为准）。不使用 **t()`** / 内置文案时可省略本步。

全局样式（App.uvue）

在应用根组件样式中引入（与示例工程一致）：

@import '@/uni_modules/m-unix/index.scss';

按需引入组件

仅使用个别组件时，可直接按路径引用（easycom 与按需二选一即可，勿重复注册）：

import MButton from '@/uni_modules/m-unix/components/m-button/m-button.uvue'

按需引入工具（libs / m-tools）

常用工具在 libs/utils.uts；网络请求在 components/m-tools/Request.uts（无 libs/request.uts 路径）：

import { formatDate, debounce } from '@/uni_modules/m-unix/libs/utils.uts'
import { request, http } from '@/uni_modules/m-unix/components/m-tools/Request.uts'

注意：Request.uts 依赖宿主工程 @/common/config 等（如 baseUrl、业务约定），接入前请按在线文档配置 common/config，否则请求层无法正常编译或运行。

组件列表

以下与 uni_modules/m-unix/components 下 *`m-组件目录**一致（按功能归类，便于检索）。**props / 事件 / 平台差异** 以 [在线文档](https://mmsadmin.cn/m-unix/README.html) 与源码注释为准；**changelog.md`** 记录版本级变更。

布局与结构

导航与路由辅助

表单与输入

展示与信息

反馈与弹层

业务与扩展

工具库（非 m-* 标签，随包或按需 import）

版权信息

mUnix（m-unix） 遵循 MIT 开源协议：可自由用于商业或个人项目，保留许可证声明即可。

出品：陕西品创网络