【后端】【UV】【Django】 `uv` 管理的项目中搭建一个 Django 项目


🚀 一步步搭建 Django 项目(适用于 uv + pyproject.toml 项目结构)


🧱 第 1 步:初始化一个 uv 项目(如果还没建好)

bash 复制代码
uv init django-project  # 创建项目,类似npm create vue

⚙️ 第 2 步:添加 Django 和 DRF(必须指定正确名字)

bash 复制代码
uv add django djangorestframework

🧠 注意:

  • 不是 django-drf,正确的是:djangorestframework
  • 避免将项目文件夹命名为 django(否则会报错 self-dependency)

🏗️ 第 3 步:创建 Django 项目

bash 复制代码
django-admin startproject config .

config 是你的主项目目录名,可以自定义
. 表示在当前目录下创建(不嵌套)

成功后你将看到文件结构类似:

复制代码
├── config/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── ...
├── manage.py
├── pyproject.toml

🧪 第 4 步:运行开发服务器验证一切正常

bash 复制代码
uv add  # 安装所有依赖(如你手动修改了 pyproject.toml)
python manage.py runserver

访问浏览器:

📍 http://127.0.0.1:8000/

看到 Django 欢迎页就成功啦!


✅ 可选增强:添加 REST Framework 到 settings

打开 config/settings.py

python 复制代码
INSTALLED_APPS = [
    ...
    'rest_framework',
]

测试你的第一个 API,可以使用:

bash 复制代码
python manage.py startapp api

然后在 api/views.py 写个简单接口,再挂到 urls.py 上。


📘 Bonus:生成 pyproject.toml 示例(完整)

toml 复制代码
[project]
name = "my-django-app"
version = "0.1.0"
dependencies = [
    "django>=5.2",
    "djangorestframework>=3.15",
]

[tool.uv]
virtualenv = ".venv"

相关推荐
花妖大人3 小时前
Python用法记录
python·sqlite
dreams_dream18 小时前
Django的Settings 配置文件详解
数据库·django·sqlite
风清再凯18 小时前
DRF序列化器
django
夜雨听萧瑟21 小时前
sqlite创建数据库,创建表,插入数据,查询数据的C++ demo
数据库·sqlite
dreams_dream1 天前
django错误记录
后端·python·django
励志五个月成为嵌入式糕手1 天前
0820 SQlite与c语言的结合
c语言·oracle·sqlite
captainOO71 天前
MRO and mixin in Python Django
后端·python·django
义达3 天前
Django环境下使用wsgi启动MCP服务
后端·django·mcp
PythonicCC4 天前
Django中的MVC和MVT模式
数据库·django·mvc