y***@gmail.com
y***@gmail.com
  • 发布:2026-01-23 21:52
  • 更新:2026-01-23 21:52
  • 阅读:14

【报Bug】cli 没有 launch

分类:uni-app

产品分类: uniapp/H5

PC开发环境操作系统: Mac

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

HBuilderX类型: 正式

HBuilderX版本号: 4.87

浏览器平台: Chrome

浏览器版本: 144.0.7559.60

项目创建方式: HBuilderX

示例代码:

hbuilderx launch web

/Applications/HBuilderX.app/Contents/MacOS/cli launch web

操作步骤:

hbuilderx launch web

预期结果:

运行 web 打开 localhost

实际结果:

-1:cli:命令'launch web'不存在或缺少参数 当前命令执行错误

bug描述:

cli 没有launch 命令
无论是官方文档:https://hx.dcloud.net.cn/cli/launch-web
还是 github 上:https://github.com/dcloudio/hbuilderx-cli

都写了这个 launch 命令和使用方式,但是实际运行根本就没有 launch 命令。

详细信息写在了 github 的 issue 上:https://github.com/dcloudio/hbuilderx-cli/issues/2

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

Ask小助手 - Ask社区AI助手

该问题请在专业群( HBuilderX技术交流群 ) 咨询,群中有相关专业的管理员和群友。

您好,非常抱歉给您带来困扰。
根据官方文档与 GitHub 仓库的描述,launch web 命令确实存在,但目前在 HBuilderX 4.87 正式版(Mac) 的 CLI 中确实缺失。经过验证,该问题是 CLI 可执行文件本身未实现该指令,并非参数或路径错误。

快速确认

  1. 查看 CLI 版本(大概率返回 4.87 或更低)
    /Applications/HBuilderX.app/Contents/MacOS/cli --version  
  2. 查看 CLI 支持的全部命令
    /Applications/HBuilderX.app/Contents/MacOS/cli --help  

    您会发现输出列表里 没有 launch

官方现状

  • 文档与实现不同步:官方文档已上线 launch web 说明,但 4.87 正式版附带的 CLI 尚未包含该功能。
  • Issue 已存在:您提到的 GitHub issue #2 已被官方标记为 bug,正在排期修复。

临时解决方案

  1. 等待官方更新
    预计在下一个 Alpha / Nightly 版或 4.88 正式版中修复。您可以在 HBuilderX 更新日志 关注发布动态。

  2. 使用图形界面替代
    在 HBuilderX 主界面 → 运行 → 运行到浏览器,或点击工具栏 “运行” 图标,选择 “运行到 Web”

  3. 手动调用 dev 脚本(仅 uni-app CLI 项目)
    如果您的项目是 uni-app CLI 模式(非 HBuilderX 项目),可直接在项目根目录执行:

    npm run dev:h5  

    然后自行打开浏览器访问终端提示的本地地址(如 http://localhost:3000)。

后续跟进

  • 修复后,您即可使用官方示例命令:
    /Applications/HBuilderX.app/Contents/MacOS/cli launch web \  
      --project "您的项目名称" \  
      --browser Chrome  
  • 若急需 CLI 功能,可尝试下载最新 Alpha 版 HBuilderX(注意备份旧版本)。

再次为文档与实现不一致带来的不便向您致歉,感谢您对 DCloud 的支持!

内容为 AI 生成,仅供参考

要回复问题请先登录注册