# 安装 vue-cli $ npm install --global vue-cli # 根据模板项目创建本地项目，目前为内网地址 $ vue init ‘bitbucket:xxx.meituan. com：hfe/mpvue-quickstart' --clone my- project # 安装依赖和启动自动构建 $ cd my-project $ npm install $ npm run dev
执行完上述命令，在当前项目的 dist 子目录将构建出小程序目标代码，使用小程序开发者工具载入 dist 目录即可启动本地调试和预览。示例项目遵循 Vue.js 模板项目规范，通过Vue.js 命令行工具vue-cli创建。代码组织形式与 Vue.js 官方实例保持一致，我们为小程序定制了 Vue.js runtime 和 webpack 加载器，此部分依赖也已经内置到项目中。
针对小程序开发中常见的两类代码复用场景，mpvue 框架为开发者提供了解决思路和技术支持，开发者只需要在此指导下进行项目配置和改造。我们内部实践了一个将 H5 转换为小程序的项目，下图为使用 mpvue 框架的转换效果：
图3： H5 和小程序转换效果
将小程序转换为H5：直接使用 Vue.js 规范开发小程序，代码本身与H5并无不同，具体代码差异会集中在平台 Api 部分。此外并不需明显改动，改造主要分如下几部分：
将小程序平台的 Vue.js 框架替换为标准 Vue.js
将小程序平台的 vue-loader 加载器替换为标准 vue-loader
适配和改造小程序与 H5 的底层 Api 差异
将H5转换为小程序：已经使用 Vue.js 开发完 H5，我们需要做的事情如下：
将标准 Vue.js 替换为小程序平台的 Vue.js 框架
将标准 vue-loader 加载器替换为小程序平台的 vue-loader
适配和改造小程序与 H5 的底层 Api 差异
根据小程序开发平台提供的能力，我们最大程度的支持了 Vue.js 语法特性，但部分功能现阶段暂时尚未实现。
表1： mpvue 暂不支持的语法特性
项目转换注意事项：框架的目标是将小程序和 H5 的开发方式通过 Vue.js 建立关联，达到最大程度的代码复用。但由于平台差异的客观存在（主要集中在实现机制、底层Api 能力差异），我们无法做到代码 100% 复用，平台差异部分的改造成本无法避免。对于代码复用的场景，开发者需要重点思考如下问题并做好准备：
尽量使用平台无的语法特性，这部分特性无需转换和适配成本
避免使用不支持的语法特性，譬如 slot， filter 等，降低改造成本
如果使用特定平台 Api ，考虑抽象好适配层接口，通过切换底层实现完成平台转换
mpvue 最佳实践
在表2中，我们对微信小程序、mpvue、WePY 这三个开发框架的主要能力和特点做了横向对比，帮助大家了解不同框架的侧重点，结合业务场景和开发习惯，确定技术方案。对于如何更好地使用 mpvue 进行小程序开发，我们总结了一些最佳实践。
使用 vue-cli 命令行工具创建项目，使用Vue 2.x 的语法规范进行开发
避免使用框架不支持的语法特性，部分 Vue.js语法在小程序中无法使用，尽量使用 mpvue 和 Vue.js 共有特性
合理设计数据模型，对数据的更新和操作做到细粒度控制，避免性能问题
合理使用组件化开发小程序，提高代码复用率
表2： 框架使用特点对比
结语
mpvue 框架已经在业务项目中得到实践和验证，目前正在美团点评内部大范围使用。mpvue 来源于开源社区，饮水思源，我们也希望为开源社区贡献一份力量，为广大小程序开发者提供一套技术方案。mpvue 的初衷是让 Vue.js 的开发者以低成本接入小程序开发，做到代码的低成本迁移和复用，我们未来会继续扩展现有能力、解决开发者的诉求、优化使用体验、完善周边生态建设，帮助到更多的开发者。
最后，mpvue 基于 Vue.js 源码进行二次开发，新增加了小程序平台的实现，我们保留了跟随 Vue.js 版本升级的能力，由衷的感谢 Vue.js 框架和微信小程序给业界带来的便利。