miniprogram-to-uniapp：一站式小程序转Uni-App解决方案
miniprogram-to-uniapp 是一个强大的转换工具，专门用于将各种小程序项目（包括微信、QQ、字节跳动、支付宝/钉钉、百度等）一键转换为 Uni-App 项目。Uni-App 是基于 Vue.js 的多端应用框架，可以编写一次代码同时发布到 iOS、Android、Web（响应式）以及各种小程序平台。
项目特点
- 多平台支持：支持微信、QQ、头条/抖音、支付宝/钉钉和百度小程序的转换
- 灵活输出：可输出标准的 Uni-App 项目或 Vue-CLI 项目
- 样式处理：支持将 WXSS 文件合并到 Vue 文件中
- 组件转换：实验性支持将 template 和 include 标签转换为单独组件
- 两种使用方式：支持 Npm 全局安装和 HBuilderX 插件两种使用方式
安装与使用
Npm 安装方式
npm install miniprogram-to-uniapp -g
安装完成后，可以使用 wtu 命令进行转换：
# 基本转换
wtu -i "./miniprogram-project"
# 将 wxss 合并到 vue 文件
wtu -i "./miniprogram-project" -m
# 转换为 vue-cli 项目
wtu -i "./miniprogram-project" -c
# 转换 template 和 include 为单独组件（实验性）
wtu -i "./miniprogram-project" -t
HBuilderX 插件方式
除了命令行方式，还可以通过 HBuilderX 插件市场安装使用，这种方式不依赖 Node.js 环境，更加便捷。
项目结构解析
miniprogram-to-uniapp 的项目结构设计合理，模块划分清晰：
- src/page/ - 页面转换相关逻辑
- src/transformers/ - 各种转换器实现
- src/utils/ - 工具函数集合
- src/project/ - 项目配置处理
核心转换器包括：
- 资源路径转换器 (assets-path-transformer.js)
- 行为转换器 (behavior-transformer.js)
- 云函数转换器 (cloudFunction-transformer.js)
- 组件转换器 (***ponent-transformer.js)
- 函数转换器 (function-transformer.js)
- 生命周期转换器 (lifecycle-transformer.js)
- 属性转换器 (properties-transformer.js)
技术实现原理
该工具主要基于 GoGoCode AST 处理库构建，通过解析小程序项目的各种文件（WXML、WXSS、JS、JSON），将其转换为 Uni-App 对应的 Vue 组件格式。转换过程包括：
- 模板转换：将 WXML 转换为 Vue 模板语法
- 样式转换：将 WXSS 转换为 CSS/SCSS，支持合并到 Vue 文件
- 脚本转换：将小程序 JS 逻辑转换为 Vue 组件逻辑
- 配置转换：将 app.json、page.json 等转换为 Uni-App 配置
使用注意事项
转换完成后，会在小程序项目的同级目录生成以"小程序项目名_uni"或"小程序目录名_uni-cli"命名的目录，这就是转换好的 Uni-App 项目。转换完成后，需要使用 HBuilderX 导入并运行。
对于复杂的项目，可能需要进行一些手动调整，特别是涉及到平台特定 API 的部分。建议在转换前备份原始项目，并在转换后进行充分的测试。
社区支持
该项目拥有活跃的社区支持，提供了多个 QQ 交流群供开发者讨论和交流使用中遇到的问题。同时项目文档详细，包含了转换原理说明和常见问题解答。
通过 miniprogram-to-uniapp 工具，开发者可以快速将现有小程序项目迁移到 Uni-App 平台，实现一次开发多端发布的目标，大大提高了开发效率和项目的可维护性。
