开发与构建脚本
生成的项目根目录包含两个脚本:dev.sh 用于开发,build.sh 用于构建与检查。
dev.sh
Section titled “dev.sh”./dev.sh start # 默认,安装依赖并启动前后端./dev.sh stop # 停止服务./dev.sh restart # 重启./dev.sh install # 只安装依赖start 会:
- 运行
install:前端npm install;Python 后端uv sync;Java 后端依赖由 Maven 自动管理。 - 启动后端:
- Python:
uv run uvicorn app.main:app --reload --host 0.0.0.0 --port 8088 - Java:
mvn spring-boot:run
- Python:
- 启动前端:
npm run dev(端口 5173)。 - 打印访问地址,并等待(
wait)。
脚本通过 trap cleanup EXIT INT TERM 在退出时同时结束后端与前端进程。
自动生成 JWT 密钥
Section titled “自动生成 JWT 密钥”当你选择 Python 后端,且环境变量 JWT_SECRET_KEY 与 backend/.env 都未设置时,dev.sh 会:
export JWT_SECRET_KEY="$(openssl rand -base64 48)"并提示「未设置 JWT_SECRET_KEY,已为本地开发自动生成随机密钥(重启后登录会失效)」。
build.sh
Section titled “build.sh”./build.sh依次执行:
- 前端构建:
cd frontend && npm run build - 后端检查:
- Python:
uv run ruff check . - Java:
mvn spotless:check
- Python:
任一环节失败,脚本因 set -e 立即退出。