Files
34047007@qq.com b95053c52c init: 初始化 dpb 桃育种系统代码库
前后端 + 后端 FastAPI 全量源码、部署脚本与文档。
2026-08-06 00:17:49 +08:00

3.3 KiB
Raw Permalink Blame History

启动需要三个部分(Redis → 后端 → 前端)。我先快速核实一下关键文件是否就位。 _backend_run.bat 实际不存在(记忆里的路径可能已变)。我查一下真正的启动脚本和后端的运行方式。 核实完毕。关键发现:记忆里的 _backend_run.bat 不存在,真实启动靠根目录 deploy.bat(后端实际用 uv run main.py run --env=dev)。我先更新一下记忆里的错误启动方式,再给你完整命令。 命令行启动项目,共三部分:Redis → 后端 → 前端deploy.bat 只管后两项,Redis 要单独起)。

CMD

CMD 比 PowerShell 更合适——deploy.bat 本身就是批处理脚本,在 CMD 里跑最干净(之前前端 pnpm dev 在 PowerShell 里会被 .ps1 执行策略拦,用 CMD 就没这问题)。

在 CMD 里启动

① 开一个 CMD 窗口,先起 Redis start "" "d:\dpb\dpb\redis\redis-server.exe" --dir d:\dpb\dpb\redis (会弹一个新窗口跑 Redis,别关)

② 再开一个 CMD 窗口,一键起后端+前端: cd /d d:\dpb\dpb deploy.bat start

③ 常用: cd /d d:\dpb\dpb deploy.bat stop
deploy.bat restart
deploy.bat status

只想单独起某一边(也是 CMD) :: 后端(新窗口) cd /d d:\dpb\dpb\backend uv run main.py run --env=dev

:: 前端(新窗口) cd /d d:\dpb\dpb\frontend\web pnpm dev

小提示:

CMD 里 deploy.bat 直接写文件名即可,不用 .\ 前缀(写 .\ 也认); 访问地址不变:前端 http://localhost:5666,后端文档 http://localhost:5667/api/v1/docs 你改过 MenuProcessor.ts 等路由文件,起前端后记得 Ctrl+Shift+R 硬刷新。

Powershell

1. 先启动 Redis(必须,漏了后端会连不上)

start "" "d:\dpb\dpb\redis\redis-server.exe" --dir d:\dpb\dpb\redis

2. 一键启动后端 + 前端(推荐)

项目根目录 d:\dpb\dpb 执行:

.\deploy.bat start

它会自动:

  • 后端:uv run main.py run --env=devcwd=backend
  • 前端:pnpm devcwd=frontend/web

常用子命令:

.\deploy.bat stop      # 停止
.\deploy.bat restart   # 重启
.\deploy.bat status    # 看状态
.\deploy.bat migrate   # 同步 breeding 表缺失列

3. 或分开手动起(调试某一边时用)

# 后端(另开一个终端,cwd=backend
cd d:\dpb\dpb\backend
uv run main.py run --env=dev
# 若 uv 不可用,退回 conda:
C:\ai\miniconda3\envs\dpb\python.exe main.py run --env=dev

# 前端(另开一个终端,cwd=frontend/web;用 cmd 跑规避 pnpm 的 .ps1 拦截)
cmd /c "cd /d d:\dpb\dpb\frontend\web && pnpm dev"

访问地址(以 settings 实际端口为准)

  • 前端页面:http://localhost:5666/web 前缀,dev 实测端口 5666
  • 后端 API 文档:http://localhost:5667/api/v1/docs
  • deploy.bat 注释里写的是 8001/5173,那是模板默认值,实际以 setting.py 的 5667/5666 为准)

两个坑提醒

  • Redis 不在 deploy.bat,必须第 1 步先起,否则后端启动后连 Redis 报错;
  • 你之前改过 router/MenuProcessor.ts 等路由初始化文件,改动后必须重启 Vite(不是 HMR),重启后 Ctrl+Shift+R 硬刷新。

需要我直接帮你按顺序把这三步跑起来吗?(启动服务涉及长驻进程,需你确认,我不会擅自起。)