docs: 添加 CLAUDE.md 说明后端虚拟环境用法

backend 有独立 .venv,系统 Python 缺少项目依赖,运行 Django 命令必须使用 backend/.venv/Scripts/python.exe。
This commit is contained in:
caoqianming 2026-04-24 10:11:00 +08:00
parent faff711915
commit 19cd3710dd
1 changed files with 26 additions and 0 deletions

26
CLAUDE.md Normal file
View File

@ -0,0 +1,26 @@
# mat3 项目指引
## 后端运行环境
后端有独立虚拟环境,路径为 `backend/.venv/`。执行 Django 管理命令、运行 Python 脚本时**必须使用**该虚拟环境的 Python否则会因系统 Python 缺少 `decouple` 等依赖而失败。
**正确用法**(从任意工作目录):
```bash
D:/projects/mat3/backend/.venv/Scripts/python.exe D:/projects/mat3/backend/manage.py <command>
```
示例:
```bash
# 运行 migration
D:/projects/mat3/backend/.venv/Scripts/python.exe D:/projects/mat3/backend/manage.py migrate
# 生成 migration
D:/projects/mat3/backend/.venv/Scripts/python.exe D:/projects/mat3/backend/manage.py makemigrations
# 启动开发服务器
D:/projects/mat3/backend/.venv/Scripts/python.exe D:/projects/mat3/backend/manage.py runserver
```
**不要**直接 `python manage.py ...`——系统 Python 没有项目依赖。