Runner 用法

一键启动生成的代码，自动准备数据库，本地跑起来。

Runner 把生成的后端/前端在你本机真正跑起来，并自动准备数据库。它帮你省掉“装依赖、建库、配端口”这一串手工活。

Runner 界面

🧪 实验性功能：Runner 会在你本机启动 / 停止进程，并依赖本机开发环境（Go / JDK / Python / Node.js 等）——启动成功与否取决于工具链安装、网络状况和依赖下载。需要稳定运行时，请使用 Docker 部署，或参阅项目 README 中的运行向导。

数据库：自动准备，绝不覆盖

启动后端时，Runner 会自动检查目标数据库：

  • 数据库不存在 → 自动创建，并执行项目里的 init.sql（建表 + 初始数据）
  • 数据库已存在 → 跳过，绝不覆盖你已有的数据

这是安全承诺：你的数据永远优先。要重建库，请手动删除后再启动。

启动后端

选择后端（Go / Python / TypeScript / Java），Runner 会自动：

  1. 检查并安装依赖（Go 的模块、Python 的 pip、TS 的 npm、Java 的 Maven）
  2. 启动服务，日志实时显示
  3. 告诉你监听端口

本地需预装：对应运行时（Go / Python / Node / JDK）和数据库驱动服务（MySQL/PostgreSQL/SQLite/MariaDB 无需）。

Docker 模式

后端目录包含 Dockerfile / docker-compose.yml 时，可改用 Docker 容器运行，避免依赖本机环境。

启动前端

选择前端（Vue / React），Runner 自动：

  1. 安装依赖
  2. 启动 dev server
  3. 自动把代理指向当前后端端口 —— 前后端直接联通，你改后端端口也不用手动改前端配置

操作区

  • 启动 / 停止：后端、前端各自独立控制
  • 日志面板：实时输出，滚动到底部自动跟随
  • 切换项目：会自动停掉旧项目的进程，避免端口冲突

常见问题

  • 端口被占？ Runner 会尝试清理自己之前的残留进程；若是别的程序占用，请手动释放端口。
  • 启动失败？ 多半是本地缺少运行时或数据库连不上，按日志提示补装。
  • 换了语言重新生成？ 生成后重新点启动即可，Runner 会重新走依赖与启动流程。