更新记录

1.1.1（2026-03-14） 下载此版本

升级将各种小程序转换为uniapp vue3

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

miniprogram-to-uniapp vue3 插件使用说明

一、插件简介

miniprogram-to-uniapp vue3 是一个 HBuilderX 本地插件，用于将 微信、QQ、头条/抖音、支付宝/钉钉、百度等小程序 转换为 uni-app Vue3 项目。
插件基于开源工具 miniprogram-to-uniapp，在转换完成后自动将工程标记为 Vue3（manifest.json 中 vueVersion: "3"）。

二、安装步骤（本地安装）

1. 准备插件目录

   • 确保当前工程目录中包含：
     • package.json
     • extension.js
     • src/main.js
     • src/transform.js
     • utils/utils.js
     • node_modules/**（尤其是 miniprogram-to-uniapp 依赖）。

2. 打包为 zip

   • 将整个插件目录（如 miniprogram-to-uniapp_2 或 miniprogram-to-uniapp-vue3）压缩为 zip 文件。
   • 注意不要排除 node_modules。

3. 在 HBuilderX 中本地安装

   • 打开 HBuilderX。
   • 菜单：“工具” → “插件安装” → “本地安装插件…”。
   • 选择刚才的 zip 文件进行安装。
   • 安装完成后 重启 HBuilderX。

三、转换小程序为 uni-app Vue3

1. 打开小程序项目

   • 使用 HBuilderX 打开待转换的小程序工程（根目录下应包含 app.json 等）。

2. 右键运行插件

   • 在左侧项目管理器中，右键点击小程序项目根目录。
   • 在菜单中选择：miniprogram to uniapp vue3。

3. 配置窗口说明

   • 源目录：显示当前选中的小程序项目路径（只读）。
   • 输出目录：默认是 源目录 + "_uni"，也可选择其它文件夹作为输出位置。
   • 转换配置选项：
     • 合并wxss文件到vue文件里：是否将 wxss 合并进 .vue。
     • 转换vant组件(wxcomponents)：是否对 Vant 组件做适配处理。
     • 转换template和include标签为组件：是否将 template/include 抽为组件。
     • 输出为 Vue3 项目（需要 HBuilderX 支持 Vue3）：
     • 默认勾选。
     • 勾选后会在转换完成后将输出工程的 manifest.json 中 vueVersion 设置为 "3"。

4. 开始转换

   • 点击 “开始转换(&S)”。
   • 若输出目录非空且为默认目录，插件会弹出覆盖确认提示。
   • 转换过程中，日志会输出到 HBuilderX 的 “miniprogram to uniapp” 输出面板。

5. 查看转换结果

   • 转换成功后，输出目录中会生成 _uni 结尾的 uni-app 工程。
   • 插件会尝试自动把该目录添加到 HBuilderX 左侧项目管理器；若未添加，可手动导入。
   • 若勾选了 Vue3 选项，可在输出工程的 manifest.json 中看到：

     "vueVersion": "3"

四、注意事项

• 不支持已由 uni-app 发布生成的小程序产物：
  检测到此类项目时会给出提示，请使用原始小程序源码进行转换。
• Vant / 第三方组件可能需要手动调整：
  部分语法并非 100% 兼容 uni-app，需要结合实际业务代码修正。
• 转换后仍需测试验证：
  建议优先在 H5 或小程序端运行验证核心功能，再处理其他端与细节问题。