环境搭建

你通常只需要搭自己负责的仓库 + 连公共 dev 环境,不需要在本地起全套微服务。

通用前置

工具	版本	用途
JDK	17+	Java 微服务
Maven	3.8+	Java 构建(各服务目录内 mvn package -DskipTests)
Node.js + pnpm	Node 18+	所有前端项目
Go	1.21+	仅 nuwa 开发者需要

公共 dev 环境网关:http://192.168.50.3:8080(前端默认代理指向它,通常无需本地起后端)。

各类项目启动

管理后台(hiapi-cloud-admin-ts)

pnpm install
pnpm dev            # http://0.0.0.0:5173,/api 代理 → 192.168.50.3:8080
pnpm build          # 类型检查 + 生产构建

依赖同级目录的 hiapi-cloud-admin-lib(file: 依赖,"main": "src",改了立即生效)。

UniApp 移动端(uniapp/hiapi-cloud-uniapp)

pnpm install
pnpm dev:h5             # H5 开发
pnpm dev:mp-weixin      # 微信小程序开发
pnpm type-check && pnpm lint:fix

API 地址在 .env.development:VITE_API_BASE_URL=http://192.168.50.3:8080。

装修组件(uniapp-design)

pnpm install && pnpm dev:h5
pnpm build:h5           # 产出 UMD 包

Java 微服务(以 vem 为例)

cd hiapi-cloud-vem
mvn package -DskipTests
# 各服务是标准 Spring Boot 多模块:-entity / -service / -app

nuwa(Go)

cd hiapi-cloud-nuwa
go run ./cmd/server
GOOS=darwin GOARCH=arm64 go test ./...

工作区标准布局(重要)

把本知识库 clone 到你项目的同级目录,你的 AI 助手(Claude Code)才能读到全局规范:

~/code/hiapi/
├── hiapi-docs/           ← 本仓库
└── hiapi-cloud-vem/      ← 你负责的项目

下一步

→ 第一个任务:加一个列表页