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

相关推荐
JonaHu21 小时前
关键词排名突然消失?用 Python、SQLite 和 SERP API 搭一套可解释的 SEO 监控
python·sqlite·seo·serp api
kyle~2 天前
SQLite -- 低成本持久化能力
数据库·sqlite
菜鸟~noob2333 天前
[AI]间章:系列走到这里,聊聊后面的规划、造卡需要的软件平台,以及为什么我要先暂停更新
人工智能·python·fpga开发·django·pygame
一条大祥脚5 天前
Agent Memory 全解析:从 SQLite、向量库 + RAG 到 Zep、Mem0
sqlite·agent·rag·智能体记忆
承渊政道6 天前
【Python编程—从入门到实践】(用户账户:给Django网站装上登录系统,让每个人拥有自己的学习笔记)
python·学习·pycharm·django
承渊政道6 天前
【Python编程—从入门到实践】(设置样式并部署:给Django网站换新装,把学习笔记发布到互联网)
python·学习·pycharm·django
wuyk5557 天前
Spider-第10讲-SQLite持久化与去重
数据库·爬虫·sqlite
FYKJ_20107 天前
springboot同人周边订单管理系统48955-计算机毕业设计、课程设计
java·javascript·vue.js·spring boot·django·php·课程设计
yuyuxun18 天前
协同过滤的校园二手物品智能推荐系统的设计与实现 毕业设计-附源码40082
javascript·vue.js·spring boot·python·数据分析·django·课程设计
2601_967987378 天前
Sqlite参考手册
数据库·python·sqlite·api·教程