跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

Django 入门:如何使用 Django 开发 Web 项目

基于 Django 框架开发 Web 项目的完整流程。内容包括安装 Django、通过命令行或 PyCharm 创建项目、理解项目与应用的区别、注册应用、配置数据库及静态文件、设置语言与时区等基础配置。此外,还详细讲解了 URL 路由配置、视图函数编写以及 HTML 模板渲染方法。最后提供了运行项目并访问验证的步骤。适合初学者快速上手 Django Web 开发。

黑客发布于 2026/3/25更新于 2026/10/25106 浏览

环境信息

  • 操作系统:Windows 11 x64
  • Python 版本:3.11
一、安装 Django

安装步骤非常简单,使用 pip 安装即可。

pip install django

安装完成后,Python 的 Scripts 文件夹下会多一个 django-admin.exe(管理创建 Django 项目的工具),Lib 文件夹下的 site-packages 下会出现 Django 源码。使用下面的命令可以查看 Django 版本号。

python -m django --version

显示:

5.0.1
二、创建与开发 Web 项目

这里记录两种创建方式,一种是命令行方式创建,一种是通过 PyCharm 方式创建。

1.1 通过命令行方式

打开终端,进入到项目将要放在的目录下,执行创建项目命令:

django-admin startproject <项目名称>

如果提示没有这个命令,有可能是没有配置环境变量,将 django-admin 的存放路径加入系统变量就可以了。

1.2 通过 PyCharm 创建项目

打开 PyCharm,左上角'文件','新建项目',左侧选择 Django,配置项目位置、Python 解析器后点击创建。

最顶上的【名称】与【位置】是项目名称与项目的存放位置。请确认使用的 Python 版本,尤其是当电脑里存在多个 Python 脚本时,一定要选择安装了 Django 的那个 Python 版本。如果电脑里只有一个 Python 版本,就不需要改动。在下面添加模板文件和【APP】名称,点击【创建】完成创建。注意区分以下两个文件夹名字,之后会用到。

创建完成后,可以看到创建了很多文件,这些都是 Django 项目的必备文件。以下是官方解释:

  • 最外层的 mysite/ 根目录只是你项目的容器,根目录名称对 Django 没有影响,你可以将它重命名为任何你喜欢的名称。
  • manage.py: 一个让你用各种方式管理 Django 项目的命令行工具。
  • 里面一层的 mysite/ 目录包含你的项目,它是一个纯 Python 包。它的名字就是当你引用它内部任何东西时需要用到的 Python 包名(比如 mysite.urls)。
  • mysite/__init__.py: 一个空文件,告诉 Python 这个目录应该被认为是一个 Python 包。
  • mysite/settings.py: Django 项目的配置文件。
  • mysite/urls.py: Django 项目的 URL 声明,就像你网站的'目录'。
  • mysite/asgi.py: 作为你的项目的运行在 ASGI 兼容的 Web 服务器上的入口。
  • mysite/wsgi.py: 作为你的项目的运行在 WSGI 兼容的 Web 服务器上的入口。

到此,项目创建完成,可以简单运行一下。PyCharm 里点击绿色三角形自动开启 Web 服务。如果是命令行创建的,则在项目的根目录下,打开终端,运行:

python manage.py runserver localhost:8000

然后打开浏览器,输入网址:

http://127.0.0.1:8000/admin

可以看到 Admin 后台的登录页面。

下面是 Django 的官方文档,里面记载了 Django 的所有详细介绍:

https://docs.djangoproject.com/zh-hans/5.0/

建议离线阅读,因为有时网络访问受限。可以当作一部字典,用到什么需求就查阅相关部分。

Django 中的 App 概念:项目和应用有什么区别?

  • 应用是一个专门做某件事的网络应用程序——比如博客系统,或者公共记录的数据库,或者小型的投票程序。项目则是一个网站使用的配置和应用的集合。项目可以包含很多个应用。应用可以被很多个项目使用。
  • 刚才访问的 http://127.0.0.1:8000/admin,是项目的后台管理,是 Django 项目自带的应用,到此处,我们并没有开发自己的应用程序。所以接下来要做的就是开发自己所需要的应用。
2. 创建 App 应用

如果是使用 PyCharm,按照截图方式创建的项目,则忽略这一步,因为已经创建好了。打开终端执行:

python manage.py startapp app01

补充删除 App 的方式:manage.py migrate my_app_name zero

3. 注册 App

如果是使用 PyCharm,按照截图方式创建的项目,则忽略这一步,因为已经注册好了。在项目的 settings.py 文件中,找到 INSTALLED_APPS 节点,新增注册语句即可完成注册:

'app01.apps.App01Config'

特别注意:如果不注册 App,那么 App 下的模型 model.py 文件中的模型类,是无法创建数据表的。

此配置需与创建项目时的应用程序名称对应,与上述手动输入的格式一样,只是应用名称不一样。

4. 配置数据库

如果没有数据库需求,或者想使用默认配置的,可以跳过此步骤。这个步骤实际上只是更改了数据库的存放目录。打开 settings.py,找到配置数据库的地方。这里使用的是 SQLite3 数据库。如果想要使用别的数据库,可以去官方文档搜索相应的引擎配置。

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

默认的路径是在项目的根目录下的,如果有需求,可以改到别的任何地方。

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': 'D:/Databases/personinfo/person.sqlite3',
    }
}
5. 一些其他配置(可有可无)

打开 settings.py。

5.1 设置语言为中文,设置时区为上海

LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'

否则可能出现中文乱码。时区一定要改,否则如果开发项目时候使用了 Django 的获取时间 API,获取的是美国时区,会比中国慢。

5.2 设置关闭网页时,结束所有会话

SESSION_EXPIRE_AT_BROWSER_CLOSE = True

5.3 设置静态文件夹位置

当需要访问静态文件时,会根据设置的文件夹去寻找。

STATICFILES_DIRS = [
    BASE_DIR / "static", # 假设你的静态文件在项目的 static 文件夹中
]
6. 编写 URL 和视图函数对应关系(urls.py 文件)
6.1 配置项目 URL

目前为止,可以在项目名称里找到一个 urls.py 文件,打开后内容如下。这就是我们之前的访问的 Admin 路径配置。

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

urlpatterns = [
    path('admin/', admin.site.urls),
]

修改如下:

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

urlpatterns = [
    path('admin/', admin.site.urls),
    path("PasswordManage/", include("PwdMgeapp.urls")),
]

几个注意的点:

  • PasswordManage 可以改为你想要的路径
  • PwdMgeapp 必须与你的应用名称相同
  • 强烈建议使用 include 包含,这样可以防止项目有多个应用时,路径重名问题。
6.2 设置应用 URL

在应用程序文件夹(PwdMgeapp)下,创建 urls.py,添加内容:

from django.urls import path
from . import views

urlpatterns = [
    path("index/", views.index, name="index"),
]
6.3 编写视图函数

PyCharm 里找到左下方的 Django 结构,在 App 下右键视图,指向'New View',点击'View Function'快捷创建视图,修改视图函数名为【index】,这里需要与 6.2 里设置的 path 名对应。

修改 index 视图函数如下:

def index(request):
    return render(request, "index.html")

如果没有使用 PyCharm,那么在【应用名】的文件夹下,找到 views.py,打开后,把上面的视图函数直接复制进去就可以了。

6.4 编写 HTML 文件

在 templates 文件夹下新建 index.html,需要与 6.3 视图函数中 render 里的参数对应。内容如下:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    welcome django
</body>
</html>

templates 里存放各种 HTML 文件,在与 templates 同目录下,创建一个 static 文件夹,用来存储静态文件,如图片、CSS、JS 等等。

6.5 运行程序

点击 PyCharm 的绿色三角形运行程序,或者命令行输入:

python manage.py runserver

启动成功后,访问下面网址:

http://127.0.0.1:8000/PasswordManage/index/

发现显示内容。

到此就运行成功。

以上是使用 Django 进行 Web 开发的最基本内容,实际上,只是 Django 的冰山一角。涉及到模板渲染、数据库操作、快捷表单等等很多知识都没有讲。官方文档中也有一个案例,也可以操作一下。建议深入研究官方文档。

目录

  1. 一、安装 Django
  2. 二、创建与开发 Web 项目
  3. 1.1 通过命令行方式
  4. 1.2 通过 PyCharm 创建项目
  5. 2. 创建 App 应用
  6. 3. 注册 App
  7. 4. 配置数据库
  8. 5. 一些其他配置(可有可无)
  9. 6. 编写 URL 和视图函数对应关系(urls.py 文件)
  10. 6.1 配置项目 URL
  11. 6.2 设置应用 URL
  12. 6.3 编写视图函数
  13. 6.4 编写 HTML 文件
  14. 6.5 运行程序

更多推荐文章

查看全部
  • STL 容器适配器 stack 与 queue 底层模拟及算法实战
  • Java Graphics2D 基础图形绘制详解
  • AI 大模型入门教程:从零基础到精通
  • 运营商高管调整与工信部人形机器人标准化委员会成立分析
  • Vue2.x 使用 SVG 实现不封闭圆形进度条及组件封装
  • Java Web 大文件分块上传与断点续传实现方案
  • 2026 年三大 AI 写作工具测评:如何消除英文 AI 痕迹
  • Web 端即时通讯聊天的三种加密算法实现方案
  • Python 常用集成开发环境(IDE)功能对比与选择指南
  • 低代码构建连锁门店管理系统:标准化与高效管控
  • 在 Cursor 中配置和使用 MCP 服务
  • 海康视频插件浏览器弹窗及灰屏问题解决方案
  • Spring Boot 1.5+ @ConfigurationProperties 移除 location 属性后的替代方案
  • 机器学习回归算法:线性回归与逻辑回归
  • 前端请求后端接口 404/405/500 状态码排查与解决指南
  • Spring Boot Starter 自定义开发:构建企业级组件库
  • Ubuntu 22.04 下基于 ROS2 Humble 的 PX4 无人机仿真环境搭建
  • Qwen3-VL WebUI 本地部署与核心功能实战指南
  • Electron 前端跨平台桌面应用开发快速入门教程
  • Z-Image Turbo 本地部署与使用指南

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online