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,里面包含:
manage.py:项目管理命令行工具(关键!)myfirstsite/:项目配置文件夹(settings.py、urls.py等)
案例: 一位初学者按照此步骤,在 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 官方文档 为准。作者不对因操作不当导致的开发环境损坏或项目失败承担责任。