# mpx
**Repository Path**: mirrors_didi/mpx
## Basic Information
- **Project Name**: mpx
- **Description**: Mpx,一款具有优秀开发体验和深度性能优化的增强型跨端小程序框架
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-06-20
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[](https://mpxjs.cn)
[Mpx](https://mpxjs.cn), 一款具有优秀开发体验和深度性能优化的增强型跨端框架,支持小程序、Web 与 React Native(iOS / Android / Harmony)输出。


## 官网及文档
欢迎访问[https://mpxjs.cn](https://mpxjs.cn),跟随我们提供的文档指南使用 Mpx 进行跨端开发。
## 近期更新
基于 Mpx 的移动端基础组件库 [mpx-cube-ui](https://www.mpxjs.cn/mpx-cube-ui/guide/intro.html) 已经开源,更多详情查看[这里](https://mpxjs.cn/articles/mpx-cube-ui.html)。
Mpx 2.9 版本正式发布,支持原子类、SSR和构建产物体积优化,更多详情查看[这里](https://mpxjs.cn/articles/2.9-release.html),迁移指南查看[这里](https://mpxjs.cn/guide/migrate/2.9.html),相关指南及 API 参考文档已更新。
## 简介
Mpx 是一款致力于提升开发体验和用户体验的增强型跨端框架,通过 Mpx,我们能够以类 Vue 的开发体验高效优雅地构筑出高性能跨端应用,在所有开放的小程序平台、Web 平台以及 React Native(iOS / Android / Harmony)环境中运行。
### 输出平台支持
| 输出类型 | 编译目标(`mode`) | Mpx 职责 |
| --- | --- | --- |
| 小程序 | `wx` / `ali` / `swan` / `qq` / `tt` / `jd` 等 | 编译产物 + 运行时 |
| Web | `web` | 编译产物 + 运行时 |
| React Native | `ios` / `android` / `harmony` | 输出 RN JS 与资源产物|
> Harmony(鸿蒙)属于 React Native 输出链路,与 iOS、Android 并列,不是独立的小程序输出形态。
Mpx具有以下功能特性:
* [数据响应](https://www.mpxjs.cn/guide/basic/reactive.html) (赋值响应 / [watch](https://www.mpxjs.cn/api/global-api.html#watch) / computed)
* [组合式 API](https://mpxjs.cn/guide/composition-api/composition-api.html)
* 增强模板语法 ([动态组件](https://www.mpxjs.cn/guide/basic/component.html#%E5%8A%A8%E6%80%81%E7%BB%84%E4%BB%B6) / [样式绑定 / 类名绑定 ](https://www.mpxjs.cn/guide/basic/class-style-binding.html#%E7%B1%BB%E5%90%8D%E7%BB%91%E5%AE%9A) / [内联事件函数](https://www.mpxjs.cn/guide/basic/event.html) / [双向绑定](https://www.mpxjs.cn/guide/basic/two-way-binding.html) / [refs](https://www.mpxjs.cn/guide/basic/refs.html))
* 极致性能 ([运行时性能优化](https://www.mpxjs.cn/guide/understand/runtime.html) / [包体积优化](https://www.mpxjs.cn/guide/understand/compile.html#%E5%88%86%E5%8C%85%E5%A4%84%E7%90%86) / 框架运行时体积14KB)
* [高效强大的编译构建](https://www.mpxjs.cn/guide/understand/compile.html#%E5%88%86%E5%8C%85%E5%A4%84%E7%90%86) (基于webpack5 / 支持持久化缓存 / 兼容webpack生态 / 兼容原生小程序 / 完善支持npm场景下的分包输出 / 高效调试)
* [单文件组件开发](https://www.mpxjs.cn/guide/basic/single-file.html)
* [渐进接入 / 原生组件支持](https://www.mpxjs.cn/guide/advance/progressive.html)
* [状态管理](https://www.mpxjs.cn/guide/advance/store.html) (Vuex规范 / 支持多实例Store)
* 跨团队开发 ([packages](https://www.mpxjs.cn/guide/advance/subpackage.html))
* 逻辑复用 ([mixins](https://www.mpxjs.cn/guide/advance/mixin.html))
* [周边能力](https://www.mpxjs.cn/guide/extend/) (fetch / api增强 / mock / webview-bridge)
* 脚手架支持
* 多平台增强 (支持在微信、支付宝、百度、qq、头条小程序平台中进行增强开发)
* [跨平台编译](https://www.mpxjs.cn/guide/advance/platform.html) (一套代码跨端输出到微信、支付宝、百度、字节、QQ、京东、快应用(web)、[Web 平台](https://www.mpxjs.cn/guide/advance/platform.html#%E8%B7%A8%E5%B9%B3%E5%8F%B0%E8%BE%93%E5%87%BAweb) 和 React Native(iOS / Android / Harmony)中运行)
* [跨端输出 React Native](https://www.mpxjs.cn/guide/rn/start.html) (支持输出到 iOS、Android 与 Harmony,延续 Mpx 单文件组件、模板、样式、运行时和 API 适配能力)
* [TypeScript支持](https://www.mpxjs.cn/guide/tool/ts.html) (基于ThisType实现了完善的类型推导)
* [I18n国际化](https://www.mpxjs.cn/guide/tool/i18n.html)
* [单元测试](https://www.mpxjs.cn/guide/tool/unit-test.html)
* [E2E测试](https://www.mpxjs.cn/guide/tool/e2e-test.html)
* [原子类](https://mpxjs.cn/guide/advance/utility-first-css.html)
* [SSR](https://mpxjs.cn/guide/advance/ssr.html)
* 运行时渲染方案
## 快速开始
```bash
# 安装mpx脚手架工具
npm i -g @mpxjs/cli
# 初始化项目
mpx create mpx-project
# 进入项目目录
cd mpx-project
# 安装依赖
npm i
# development
npm run serve
# production
npm run build
```
使用小程序开发者工具打开项目文件夹下 `dist` 中对应平台的文件夹即可预览效果。
### React Native 快速开始
创建项目时选择支持 React Native 的模板后,可按目标平台开发与构建(具体脚本名以脚手架生成为准):
```bash
# 开发调试
npm run serve:ios
npm run serve:android
npm run serve:harmony
# 生产构建
npm run build:ios
npm run build:android
npm run build:harmony
```
Mpx 负责将业务源码编译为 RN JS bundle 与资源,产物通常输出到 `dist/react-native/`(或项目内 RN 容器工程的约定目录)。iOS / Android / Harmony 三端共用同一套 Mpx 源码与编译配置,差异通过 `mode` 与条件编译(`.ios.mpx` / `.android.mpx` / `.harmony.mpx`)处理。
## 跨端输出 React Native
Mpx 已支持将同一套基于微信增强语法编写的业务源码输出为 React Native 应用,覆盖 iOS、Android 与 Harmony 三类运行环境。RN 输出会尽量保留 Mpx 原有的开发体验,包括单文件组件、数据响应、组合式 API、条件编译、基础组件、样式编译、路由和 `@mpxjs/api-proxy` 环境 API 适配等能力。
需要特别说明的是,Mpx 对 Harmony 的支持属于 React Native 输出链路的一部分:开发者使用 `harmony` 作为编译目标时,Mpx 负责生成可被 Harmony 侧 React Native / RNOH 工程消费的 JS 与资源产物;原生工程创建、打包、签名和发布仍由对应的 Harmony RN 容器与工具链完成。这意味着 Harmony 不是一套独立的小程序输出形态,而是与 iOS、Android 并列的 RN 运行目标。
在 RN 平台(`ios` / `android` / `harmony`)中,文件维度条件编译也提供兜底逻辑:当 `android` 或 `harmony` 目标没有命中对应平台文件时,会自动兜底查找 `.ios` 文件。因此在多数业务场景下可以先编写一份 RN 通用实现(如 `index.ios.mpx`),再针对 Android 或 Harmony 的差异补充 `.android.mpx` / `.harmony.mpx` 文件。更多内容可查看 [RN 快速开始](https://www.mpxjs.cn/guide/rn/start.html) 和 [RN 平台文件兜底逻辑](https://www.mpxjs.cn/guide/cross-platform/conditional.html#rn-platform-fallback)。
## 使用示例
```html
{{title}}
{{reversedTitle}}
{{item.content}}
wx env
ali env
harmony env
```
更多示例请查看[官方示例项目](https://github.com/didi/mpx/tree/master/examples)
## 设计思路
Mpx的核心设计思路为增强,不同于业内大部分小程序框架将web MVVM框架迁移到小程序中运行的做法,Mpx以小程序原生的语法和技术能力为基础,借鉴参考了主流的web技术设计对其进行了扩展与增强,并在此技术上实现了以微信增强语法为base的同构跨平台输出,该设计带来的好处如下:
* 良好的开发体验:在方便使用框架提供的便捷特性的同时,也能享受到媲美原生开发的确定性和稳定性,完全没有`框架太多坑,不如用原生`的顾虑;不管是增强输出还是跨平台输出,最终的dist代码可读性极强,便于调试排查;
* 极致的性能:得益于增强的设计思路,Mpx框架在运行时不需要做太多封装抹平转换的工作,框架的运行时部分极为轻量简洁,压缩+gzip后仅占用14KB;配合编译构建进行的包体积优化和基于模板渲染函数进行的数据依赖跟踪,Mpx框架在性能方面做到了业内最优([小程序框架运行时性能评测报告](https://github.com/hiyuki/mp-framework-benchmark/blob/master/README.md));
* 完整的原生兼容:同样得益于增强的设计思路,Mpx框架能够完整地兼容小程序原生技术规范,并且做到实时跟进。在Mpx项目中开发者可以方便地使用业内已有的小程序生态,如组件库、统计工具等;原生开发者们可以方便地进行渐进迁移;甚至可以将框架的跨平台编译能力应用在微信的原生小程序组件当中进行跨平台输出。
## 生态周边
|包名|版本|描述|
|-----|----|----|
|@mpxjs/core|[](https://badge.fury.io/js/%40mpxjs%2Fcore)|mpx运行时核心|
|@mpxjs/webpack-plugin|[](https://badge.fury.io/js/%40mpxjs%2Fwebpack-plugin)|mpx编译核心|
|@mpxjs/api-proxy|[](https://badge.fury.io/js/%40mpxjs%2Fapi-proxy)|将各个平台的 api 进行转换,也可以将 api 转为 promise 格式|
|@mpxjs/store|[](https://badge.fury.io/js/%40mpxjs%2Fstore)|类vuex store|
|@mpxjs/pinia|[](https://badge.fury.io/js/%40mpxjs%2Fpinia)|mpx pinia store|
|@mpxjs/fetch|[](https://badge.fury.io/js/%40mpxjs%2Ffetch)|mpx网络请求库,处理wx并发请求限制|
|@mpxjs/unocss-plugin|[](https://badge.fury.io/js/@mpxjs%2Funocss-plugin)|mpx unocss插件,支持使用unocss原子类|
|@mpxjs/unocss-base|[](https://badge.fury.io/js/@mpxjs%2Funocss-base)|mpx unocss预设|
|@mpxjs/cli|[](https://badge.fury.io/js/%40mpxjs%2Fcli)|mpx脚手架命令行工具|
|@mpxjs/webview-bridge|[](https://badge.fury.io/js/%40mpxjs%2Fwebview-bridge)|为跨小程序平台的H5项目提供通用的webview-bridge|
|@mpxjs/utils|[](https://badge.fury.io/js/%40mpxjs%2Futils)|mpx运行时工具库|
|@mpxjs/babel-plugin-inject-page-events|[](https://badge.fury.io/js/%40mpxjs%2Fbabel-plugin-inject-page-events)|组合式API页面事件处理插件|
|@mpxjs/mpx-cube-ui|[](https://badge.fury.io/js/%40mpxjs%2Fmpx-cube-ui)|基于 Mpx 的移动端基础组件库|
## 开发团队
核心团队: [hiyuki](https://github.com/hiyuki), [Blackgan3](https://github.com/Blackgan3), [anotherso1a](https://github.com/anotherso1a), [CommanderXL](https://github.com/CommanderXL), [yandadaFreedom](https://github.com/yandadaFreedom), [wangxiaokou](https://github.com/wangxiaokou), [OnlyProbie](https://github.com/OnlyProbie), [pagnkelly](https://github.com/pagnkelly), [thuman](https://github.com/thuman), [theniceangel](https://github.com/theniceangel), [dolymood](https://github.com/dolymood)
外部贡献者:[sky-admin](https://github.com/sky-admin), [pkingwa](https://github.com/pkingwa), [httpsxiao](https://github.com/httpsxiao), [lsycxyj](https://github.com/lsycxyj), [okxiaoliang4](https://github.com/okxiaoliang4), [tangminFE](https://github.com/tangminFE), [codepan](https://github.com/codepan), [zqjimlove](https://github.com/zqjimlove), [xuehebinglan](https://github.com/xuehebinglan), [zhaoyiming0803](https://github.com/zhaoyiming0803), [ctxrr](https://github.com/ctxrr), [JanssenZhang](https://github.com/JanssenZhang), [heiye9](https://github.com/heiye9), [lj0812](https://github.com/lj0812), [SuperHuangXu](https://github.com/SuperHuangXu), [twtylkmrh](https://github.com/twtylkmrh), [NineSwordsMonster](https://github.com/NineSwordsMonster)
## 成功案例
微信小程序
|  |  |  |  |||
|:---:|:-------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------:|:---:|:---:|
|滴滴出行|出行广场|滴滴公交|滴滴金融|滴滴外卖|司机招募|小桔加油|
||  |  |  |  |||
|彗星英语|番薯借阅|疫查查应用| 小桔养车 | 学而思直播课 |小猴启蒙课|科创书店|
||  |  |  |  |||
|在武院|三股绳Lite|学而思优选课| 食享会 | 青铜安全医生 |青铜安全培训|视穹云机械|
||  |  |  |  |||
|店有生意通|花小猪打车|橙心优选| 小二押镖 | 顺鑫官方微商城 |嘀嗒出行|汉行通Pro|
||  |  || |||
|交圈|青桔单车|滴滴顺风车|滴滴代驾|新桔代驾|标贝知音||
其他平台小程序:
|||||||
|:---:|:---:|:---:|:---:|:---:|:---:|
|滴滴出行(支付宝)|小桔充电(支付宝)|唯品会(QQ)|口袋证件照(百度)|唯品会(百度)|唯品会(字节)|
[更多案例](https://github.com/didi/mpx/issues/385),若你也在使用Mpx框架开发小程序,并想分享给大家,请填在此issue中。
## 交流
提供 微信群 / QQ群 两种交流方式
#### 添加MPX入群小助手等待受邀入群

#### 扫码进入QQ群

图片因github网络问题导致不可见的朋友可以点击该链接:https://s.didi.cn/rod