How to Create a Django Project in Python: Step-by-Step Guide(2026-07-10)

如果你正在寻找一个既强大又易于上手的 Python Web 框架,Django 几乎总是首选。根据 2026 年 Stack Overflow 开发者调查,Django 在“最受喜爱的 Web 框架”中排名前四,全球超过 45 万网站基于它构建。从 Instagram 到 Disqus,Django 证明了自己能支撑百万级流量。

下面,我将带你一步步从零开始,创建一个完整的 Django 项目。即使是编程新手,也能在 15 分钟内跑起来。

第一步:环境准备(5分钟)

安装 Python 和虚拟环境

首先,确保你的电脑安装了 Python 3.9+。打开终端(或命令提示符),输入:

python --version

如果版本低于 3.9,请去 python.org 下载最新版。

接着,为每个项目创建独立的虚拟环境,避免包冲突:

# 创建虚拟环境
python -m venv myproject_env

# 激活环境(Windows)
myproject_env\Scripts\activate

# 激活环境(Mac/Linux)
source myproject_env/bin/activate

实用建议: 虚拟环境就像项目的“独立沙盒”——你安装的 Django 版本不会影响其他项目。

第二步:安装 Django 并创建项目

安装 Django

在激活的虚拟环境中,一行命令搞定:

pip install django

安装完成后,验证版本:

django-admin --version

创建第一个 Django 项目

运行以下命令,Django 会自动生成项目骨架:

django-admin startproject myfirstsite

你会看到一个新文件夹 myfirstsite,里面包含:

案例: 一位初学者按照此步骤,在 10 分钟内创建了一个博客基础框架——而如果用 Flask 手写,通常需要 30 分钟以上。

第三步:运行开发服务器并查看效果

启动服务器

进入项目文件夹,运行:

cd myfirstsite
python manage.py runserver

终端会显示类似信息:

Starting development server at http://127.0.0.1:8000/

访问你的第一个网站

打开浏览器,输入 http://127.0.0.1:8000。你会看到 Django 的默认欢迎页面——那个经典的火箭图标!🎉

数据: Django 的开发服务器默认支持热重载——你修改代码后,只需保存,服务器会自动刷新(不必手动重启)。

第四步:创建你的第一个应用

一个 Django“项目”可以包含多个“应用”(apps)。每个应用负责一个独立功能。

python manage.py startapp blog

接着,将 blog 注册到项目。打开 myfirstsite/settings.py,在 INSTALLED_APPS 列表中添加 'blog'

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    # ...其他内置应用
    'blog',  # 你的新应用
]

实用建议: 每个应用都应该“小而专”——一个博客应用只负责文章,评论应用可以单独创建。这符合 Django 的“松耦合”哲学。

第五步:编写一个简单的视图(到达中转站)

blog/views.py 中添加代码:

from django.http import HttpResponse

def home(request):
    return HttpResponse("你好,这是我的第一个 Django 页面!")

然后,在 blog 文件夹中创建 urls.py 文件,写入:

from django.urls import path
from . import views

urlpatterns = [
    path('', views.home, name='home'),
]

最后,在项目主 urls.py 中引入:

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('blog.urls')),  # 将博客路由挂载到根路径
]

刷新浏览器,你会看到自定义的问候文字!

下一步做什么?

现在你的 Django 项目已经能跑了——但这只是开始。真正挑战是构建用户认证、数据库模型和模板系统。

行动号召: 立刻打开终端,输入 python -m django --help,看看 Django 内置了多少命令。然后,访问 Django 官方教程,用 1 小时完成一个投票应用。当你亲手创建第一个数据库表并看到页面数据变化时,那种成就感无可替代!

记住:每个熟练的 Django 开发者都是从 startproject 这一步开始的。你的第一个项目不必完美——开始动手,才是最重要的。


免责声明: 本文提供的代码和步骤基于 Django 5.0 版本撰写,适用于 2026 年主流开发环境。不同版本之间可能存在细微差异(例如 Python 版本要求或新增功能)。如有特定环境限制,请以 Django 官方文档 为准。作者不对因操作不当导致的开发环境损坏或项目失败承担责任。