如何创建一个 Django 项目（译）

Sun, 16 Aug 2026 16:02:38 +0000

Django 是一个功能丰富的 Python web 框架，但这并不代表它具有全部所需的功能。本文是一个构建和配置 Django 项目的实用指南，也包括了附加的库以及我的一些想法。本文的读者最好能有一些使用 Django 的经验。读者可以用官方教程温习一下 Django 的基础。

首先安装 uv ，然后使用这个命令创建一个虚拟库（virtual package）作为我们的项目（awesome_site）：

1uv init --virtual awesome_site

然后删除默认的 main.py 并创建新 Django 项目：

1cd awesome_site
2rm main.py
3uv add 'django==5.2.*'
4uv run django-admin startproject django_project

在上面的代码中，我安装了 Django 5.2 并创建了一个名为 django_project 的 Django 项目。

我安装 Django 5.2 的原因是 Django x.2 版本会得到3年的支持（LTS）。Django 长期支持版的大部分更新都是安全更新，而非功能更新，所以我们不需要频繁地重写我们的代码。不断地重写代码来追最新的 Django 版本是一项很繁琐的工作。

我虽然可以为上文的 Django 项目随意命名，但是仍把这个项目命名为 django_project，其中一个原因是 uv 创建的母项目 awesome_site 已经是我想要的项目名。另外一个原因是，在此项目中，Django 会在 django_project/django_project 目录储存配置文件，这样的项目名可以帮助我们快速找到配置文件目录。

uv 切换安装源

Sun, 21 Sep 2025 22:25:12 +0800

uv 是一个 Python 包管理器。不同于其他 Python 包管理器的是，uv 并没有一个通用的换源方式。在 macos 和 Linux 上，最好的换源方式是修改 shell 配置。

以 zsh 为例，在家目录中的 .zshrc 文件加入这行代码即可让 uv 默认使用清华 PyPI 源。

1export UV_DEFAULT_INDEX='default=https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple'

初次使用时，注意重启终端或 shell 来让配置生效。

泽塔地带

如何创建一个 Django 项目（译）

uv 切换安装源