【后端】【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"

相关推荐
m0_7472660912 小时前
contentprovider实验+SQLite数据库的实现
数据库·sqlite
电商数据girl17 小时前
如何利用API接口与网页爬虫协同进行电商平台商品数据采集?
大数据·开发语言·人工智能·python·django·json
小王子10242 天前
Django模型查询与性能调优:告别N+1问题
数据库·django·查询·n+1
计算机毕设定制辅导-无忧学长2 天前
InfluxDB 与 Python 框架结合:Django 应用案例(二)
python·django·sqlite
2025年一定要上岸2 天前
【Django】-1- 开发项目搭建
数据库·django·sqlite
java1234_小锋2 天前
[免费]基于Python的招聘职位信息推荐系统(猎聘网数据分析与可视化)(Django+requests库)【论文+源码+SQL脚本】
python·数据分析·django·python招聘系统·django招聘
m0_620355192 天前
sqlite3学习---基础知识、增删改查和排序和限制、打开执行关闭函数
数据库·学习·sqlite