---
description: 本地开发启动约定：后端工作目录、唯一数据目录、单实例，避免头像/上传 404
alwaysApply: true
---

# 本地开发环境

## 后端启动（必须遵守）

规范命令与 `start.bat` / `start.sh` 一致：

```
cd backend
go run ./cmd/jiang13
```

- 数据目录**只有** `backend/data/`（头像在 `backend/data/uploads/avatars/`）
- 配置文件是 `backend/app.ini`，不是仓库根、也不是 `cmd/jiang13/`
- **禁止**在仓库根、`backend/cmd/jiang13/` 或其他目录执行 `go run`（会另建一套 data，DB 里头像 URL 对不上文件）
- **禁止**同时跑两个后端。启动前若 `:3001` 已在听，沿用现有进程，或先停再启；不要再开一个
- 启动日志必须含 `workPath=.../backend` 且 `dataDir=.../backend/data`。若不是，立刻停掉重来
- 覆盖工作目录只用环境变量 `JIANG13_WORK_PATH`（指向 `backend/`）

## 前端

```
cd frontend
npm.cmd run dev
```

`:3000` 把 `/uploads` rewrite 到 `:3001`。头像 404 先查后端 `dataDir`，不要改前端。

## 遗留目录

`backend/cmd/jiang13/data/` 是错误 cwd 的产物，禁止当数据源。发现后把 `uploads/` 合并进 `backend/data/uploads/`，再删遗留目录。