快速上手

前序准备

序号	描述	操作
1	克隆 ai-go-admin 代码到本地
2	Golang >= 1.26.6	官方下载
3	PostgreSQL >= 18.3	官方下载
4	NodeJs >= 22.13.0	官方下载
5	pnpm >= 10.33.2	达成指引

配置数据库

于 config/config.yaml 文件内配置数据库连接信息。

还可以使用环境配置文件，即：将 .env.yaml.example 重命名为 .env.yaml，其中填写好数据库连接信息。

启动前后端开发服务

🌐 服务端

# 安装服务端依赖
go mod tidy

# 1. 应用数据库迁移
go run cmd/main.go migrate up

# 2. 全局安装 Air（实现服务端代码改变自动热重载）
go install github.com/air-verse/air@latest

# 3. 启动 API 服务
air

🧑‍💻 前端

# 切换到前端根目录
cd web

# 安装依赖
pnpm i

# 启动开发服务（带前端代码改变热更新）
pnpm dev

✈️ 体验

前后端两个服务启动后，浏览器访问：localhost:1818，后台账号 admin，密码 admin888。

使用 Docker

开发环境前后端都有热更新服务：监听磁盘文件改变，服务端会重新编译并运行，前端代码会热更新至浏览器

热更非常依赖文件系统事件，而 Windows 宿主 + Docker 绑定挂载下文件变更通知经常不灵（WSL2/notify 问题），Air 和 Vite HMR 都可能不触发或延迟。

所以我们暂时未提供一键部署开发环境的 Dockerfile 或者是 docker-compose.yml。