2***@qq.com
2***@qq.com
  • 发布:2026-01-23 19:02
  • 更新:2026-01-23 19:06
  • 阅读:19

【报Bug】uniapp的uni_modules 打包没有生效

分类:uni-app

产品分类: uniapp/H5

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: w11

HBuilderX类型: 正式

HBuilderX版本号: 4.87

浏览器平台: Chrome

浏览器版本: 143.0.7499.193

项目创建方式: HBuilderX

操作步骤:

uniapp的uni_modules 打包没有生效

预期结果:

uniapp的uni_modules 打包没有生效

实际结果:

uniapp的uni_modules 打包没有生效

bug描述:

uniapp的uni_modules 打包没有生效

2026-01-23 19:02 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

需要补充平台分类,HBuilderX版本信息,以及详细的报错信息。
该问题请在专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

您好,根据目前掌握的信息,还无法判断「uni_modules 打包没有生效」的具体原因。为了帮您快速定位并解决问题,请先确认以下关键信息,并按对应步骤自查或补充:

  1. 出问题的 uni_modules 插件
    • 插件名称、版本号
    • 插件类型:
    ‑ 纯前端组件(Vue/JS)
    ‑ 含原生依赖(Android/iOS 原生库、UTS 插件、uni原生插件)

  2. 打包目标平台
    App-Android / App-iOS / 各家小程序 / H5 / 鸿蒙

  3. 打包方式
    • 云端打包
    • 离线打包(本地 Xcode / Android Studio)
    • CLI 打包(vite/webpack)

  4. “没有生效”的具体表现
    • 安装包里找不到对应文件?
    • 运行时报错 xxx is not defined
    • 原生功能(蓝牙、推送等)调用无响应?
    • 其它现象(请描述)

  5. 自查清单(90 % 的类似问题都能通过下面 3 步解决)

    1. 原生插件 / UTS 插件 必须走「自定义基座」或「云端正式打包」
      ‑ 标准基座、真机运行、HBuilderX 的「运行到浏览器」都不会包含原生依赖。
      ‑ 操作路径:HBuilderX → 发行 → 原生 App-云打包 → 勾选「自定义调试基座」或使用正式打包。
      官方文档:自定义基座步骤

    2. 确认 manifest.json 已正确声明

      "app-plus": {  
      "modules": {  
        "YourPluginName": {}  
      }  
      }  

      并在「App原生插件配置」里勾选了对应插件。

    3. 版本一致性检查
      ‑ 云端打包机目前 Xcode 16.1 / iOS SDK 18.1,Android 端 API 34。
      ‑ 如果插件源码使用了 iOS 16+ 或 Android 14+ 的私有/新 API,而您本地 SDK 版本过低,也会导致“打包后无效”。
      版本差异说明

  6. 仍无法解决?
    请按第 1~4 点补充信息后,提供:
    • 最小可复现 demo(把项目精简到只剩该 uni_modules)
    • 打包日志(云端打包可在「发行日志」里下载)
    • 控制台完整报错截图

我们将根据您补充的材料继续跟进。

内容为 AI 生成,仅供参考
2***@qq.com

2***@qq.com (作者)

控制台没有报错 正常运行就可以正常编译 打包之后就无法正常显示(插件安装在uni_modules里)但打包没有生效

要回复问题请先登录注册