Skip to content

hohu dev ​

在一个终端启动组件开发服务,合并显示带组件前缀的日志。命令在前台持续运行,适用于本机开发。

前提条件 ​

完成 hohu init,数据库、Redis 和配置可用。在项目根目录或子目录运行。

用法与参数 ​

bash
hohu dev [OPTIONS]
参数说明默认值
--only / -o仅启动指定组件,可重复项目声明的全部组件
--skip / -s跳过指定组件,可重复不跳过
--app-target / -tApp 目标:h5、mp、apph5
组件接受的名称,大小写不敏感
Backendbackend、be、admin
Webfrontend、fe、web
Appapp

同时指定 --only 和 --skip 时,先选入再排除;被跳过的组件不启动。仅筛选已有组件,不下载源码。当前未知名称会被忽略,请核对启动列表。

常用示例 ​

bash
# 全部开发服务
hohu dev

# 仅 Backend + Web
hohu dev --only backend --only web

# 跳过 App
hohu dev --skip app

# 仅 App 微信小程序目标
hohu dev --only app --app-target mp

h5、mp、app 分别调用 App 的 pnpm dev、pnpm dev:mp、pnpm dev:app。小程序和原生 App 仍需相应平台工具;CLI 不自动启动微信开发者工具或完成原生打包。

确认启动与停止 ​

日志按 [Backend]、[Frontend]、[App] 标记。标准 Web 默认地址为 http://localhost:9527,后端为 http://127.0.0.1:8000,接口文档为 http://127.0.0.1:8000/docs;实际地址以组件输出为准。

打开 Web 并完成登录,确认前后端连接。开发后端默认设置 APP_ROLE=all,在单进程中同时运行调度器;生产方式见部署指南。

在启动终端按 Ctrl+C,CLI 会终止它启动的子进程。

排错 ​

现象处理方式
没有组件启动核对项目标记、筛选名称和相互排除的参数
某组件被跳过检查源码目录与启动命令,修复后重试
端口占用或进程退出阅读对应组件日志,检查端口和配置
Web 正常但登录失败确认 Backend 可用,核对 Web 服务地址与代理

部分组件失败时,其他组件可能仍在运行。先按 Ctrl+C,再修复并启动;更多问题见配置与排错。