znus
znus
  • 发布:2026-07-08 10:28
  • 更新:2026-07-08 10:34
  • 阅读:266

使用自定义基座运行,清理构建缓存后提示ts插件[xxxxxxxxx]不存在,请重新打包自定义基座

分类:HBuilderX

5.14版本出现该问题,在5.07版本没有改问题 ,如果停止运行 ,不勾选清理构建缓存后没有该问题

2026-07-08 10:28 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

欢迎到专业群( HBuilderX技术交流群 ) 咨询,群中有相关专业的管理员和群友。

这个问题在 5.14 版本中出现,属于已知的构建缓存清理逻辑变更导致的兼容性问题。核心原因是:勾选“清理构建缓存”后,编译器会清除之前自定义基座中已打包的 uts 插件信息,导致运行时无法找到对应的插件。

根据 DCloud 官方在 ask 社区中的反馈,可以按以下步骤解决:

排查与解决步骤

  1. 手动删除缓存目录(关键步骤)
    不要勾选“清理构建缓存”选项,而是手动删除项目根目录下的缓存文件夹。

    • 关闭 HBuilderX 当前项目。
    • 在系统文件管理器中,进入你的项目目录,找到 unpackage 文件夹。
    • 手动删除 unpackage/cache 这个子目录。
    • 重新打开 HBuilderX 项目。
  2. 重新打包自定义基座
    由于缓存已被彻底清除,需要重新制作一次包含所有 uts 插件的自定义基座。

    • 在 HBuilderX 顶部菜单,选择【运行】->【运行到手机或模拟器】->【制作自定义调试基座】。
    • 等待云端打包完成,并下载安装新生成的基座。
  3. 运行项目

    • 打包完成后,再次通过【运行】菜单选择你的目标设备。
    • 在运行设置弹窗中,确保“运行基座选择”已勾选为“自定义调试基座”。
    • 务必确保“清理构建缓存”选项处于未勾选状态,然后点击运行。

补充说明

  • 这个问题的根源在于 5.14 版本对构建缓存的清理策略进行了调整,导致 uts 插件的编译产物与缓存目录的关联更紧密。ask 社区中也有其他开发者在多个版本中遇到过类似情况,手动删除 unpackage/cache 目录并重新打包基座是目前最有效的通用解决方案(参考 DCloud问答_186766)。
  • 如果你在手动删除缓存并重新打包后问题依旧,请检查项目中的 uni_modules 目录下,对应的 uts 插件文件夹是否完整存在,确保插件本身没有被误删或移动。
内容为 AI 生成,仅供参考
znus

znus (作者)

但是有时候需要勾选清理构建缓存怎么办

要回复问题请先登录注册