苏姝
苏姝
  • 发布:2026-02-02 11:08
  • 更新:2026-02-02 13:04
  • 阅读:25

hbx4.87,普通uni-app旧项目发布为手机h5无法选中,想自定义发布也没有选项,怎么回事,我想要发布为h5请大佬解惑

分类:uni-app
2026-02-02 11:08 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

您遇到的问题是:在 HBuilderX 4.87 中,旧项目无法通过“运行”或“发行”方式发布为 H5,且“自定义发布”选项也不可见。

✅ 原因分析

这通常是因为 项目结构或配置不符合 H5 发布条件,导致 HBuilderX 没有识别出这是一个可以发布为 H5 的项目。常见原因如下:


✅ 解决方案(按优先级)

✅ 1. 检查 manifest.json 是否包含 H5 平台配置

打开 manifest.json,确认是否存在以下字段:

"h5": {  
  "title": "您的项目名",  
  "router": {  
    "mode": "hash"  
  }  
}

如果没有,手动添加这个字段,保存后重新打开 HBuilderX。


✅ 2. 确认项目类型是否为 uni-app 项目

  • 项目根目录必须有 pages.jsonmanifest.json
  • 如果是老的非 uni-app 项目(如纯 Vue 项目),HBuilderX 不会显示 H5 发布选项

✅ 3. 使用“发行”而非“运行”

  • 运行到浏览器 ≠ 发布 H5
  • 正确路径是:
    顶部菜单栏 → 发行 → 网站-H5手机版  

✅ 4. 如果“网站-H5手机版”选项灰色或不可见

请尝试以下操作:

操作 说明
升级 HBuilderX 到最新正式版 当前为 4.87,建议重新下载安装 官网链接
新建一个空的 uni-app 项目 测试是否能正常看到“网站-H5手机版”选项
将旧项目代码逐步迁移到新项目中 排除旧项目配置异常

✅ 5. 自定义发布不可见

“自定义发布”功能只在以下情况出现:

  • 项目根目录存在 vue.config.jsvite.config.js
  • 或者您使用了 uni-app x 项目结构

普通 uni-app 项目不会显示“自定义发布”。


✅ 总结一句话

您的项目可能是老项目结构不完整或缺少 manifest.json 中的 h5 配置,导致 HBuilderX 无法识别为可发布 H5 的 uni-app 项目。建议新建一个标准 uni-app 项目,将代码迁移过去,再使用“发行 → 网站-H5手机版”即可。

如需帮您检查 manifest.json 内容,可以贴出来我帮你看。

内容为 AI 生成,仅供参考
r***@sina.com

r***@sina.com

上述说的我的文件都满足,我没有自定义发布,没有vue.config.js 或 vite.config.js,但现在的问题是:发布到前端托管网页上传失败。

要回复问题请先登录注册