当前位置:首页 > 技术 > 正文内容

Django 入门:安装与配置指南

访客 技术 2026年6月25日 2

Django 入门:安装与配置指南

Python 主流 Web 框架概览

在 Python 生态中,有多种 Web 框架可供选择,各有其特点:

  • Django:一个功能全面的 MVC 框架,提供开箱即用的强大功能,如 ORM、Admin 后台和表单处理。其"大而全"的特性意味着它可能占用更多资源,但对于复杂项目非常高效。
  • Flask:一个轻量级的"微框架",核心简单,仅提供最基本的功能。开发者需要根据需求集成第三方扩展,这带来了灵活性,但也可能引发兼容性问题。
  • Tornado:一个高性能的异步网络库,支持非阻塞 I/O,特别适合处理高并发的实时应用,甚至可以用于构建游戏服务器。

此外,还有如 Sanic、FastAPI 等新兴框架,它们通常专注于高性能和异步支持。

Django 简介

版本选择

Django 的版本发展迅速,了解其版本生命周期有助于选择合适的版本进行开发:

  • 1.x 系列:最终版本为 1.11,曾广泛使用,现已进入维护阶段。
  • 2.x 系列:最终版本为 2.2,目前仍被大量项目采用,是许多现有项目的稳定选择。
  • 3.x 系列:最终版本为 3.2,引入了对异步视图的支持,是官方推荐的新项目起点。
  • 4.x 系列:最新版本,包含最新特性和改进,但可能尚未被广泛采用。

对于学习,推荐使用稳定且广泛支持的 2.2.22 版本。

安装步骤

使用 pip 命令可以轻松安装指定版本的 Django:

pip install django==2.2.22

如果安装速度慢,可以指定国内镜像源,例如:

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple django==2.2.22

安装时会自动替换旧版本。

安装注意事项

  • 计算机名称请勿使用中文字符,以免引发路径解析错误。
  • 确保 Python 解释器版本与 Django 版本兼容。
  • 项目中的所有文件和文件夹名称建议使用英文。
  • 保持项目结构扁平化,避免多层嵌套。

Django 常用操作

验证安装

安装成功后,可以在终端中运行以下命令来验证 Django 是否已正确安装并添加到系统路径:

django-admin --version

核心命令

Django 提供了一系列命令行工具来管理项目和应用:

# 1. 创建一个新的 Django 项目
django-admin startproject my_project

# 2. 启动开发服务器
cd my_project
python manage.py runserver 127.0.0.1:8000
# 省略 IP 和端口时,服务器默认在 8000 端口启动

# 3. 在项目中创建一个新的应用
python manage.py startapp my_app

在 PyCharm 中配置

  1. 创建项目:在 PyCharm 中创建新项目时,可以选择"Django"模板,它会自动生成项目结构和必要的配置文件。
  2. 配置模板路径:在项目的 settings.py 文件中,需要配置模板文件的存储路径。通常,这通过 DIRS 列表指定,以便 Django 能找到 HTML 模板文件。
  3. 注册应用:在 INSTALLED_APPS 列表中添加你的应用,以便 Django 能识别它。可以简写为应用名,也可以使用全路径。
INSTALLED_APPS = [
    ...
    'my_app',  # 简写形式
    'another_app.apps.AnotherAppConfig',  # 全路径形式
]

Django 项目文件结构

一个典型的 Django 项目包含以下核心文件和目录:

  • 项目根目录(与项目同名):
    • settings.py:项目的核心配置文件,包含数据库、应用、中间件等设置。
    • urls.py:URL 路由配置文件,定义 URL 模式与视图函数的映射关系。
    • wsgi.py:WSGI 兼容的 Web 服务器入口文件。
  • manage.py:一个命令行工具,用于执行各种项目管理任务(如运行服务器、迁移数据库等)。
  • 应用目录(例如 my_app):
    • migrations/:存储数据库迁移文件的目录。
    • admin.py:注册模型到 Django 自带的 Admin 后台管理界面。
    • apps.py:应用配置文件。
    • models.py:定义数据模型的文件,与数据库交互的核心。
    • tests.py:用于编写应用测试的文件。
    • views.py:视图文件,包含处理请求和返回响应的业务逻辑。
  • templates/:存放 HTML 模板文件的目录,用于渲染动态内容。
  • db.sqlite3:Django 默认使用的小型 SQLite 数据库文件(项目首次运行时生成)。

基本视图操作

views.py 中,你可以定义视图函数来处理请求并返回响应。以下是三种常见的响应方式:

from django.http import HttpResponse
from django.shortcuts import render, redirect

def home_view(req):
    # 1. 返回简单的文本响应
    # return HttpResponse("这是一个简单的文本响应。")

    # 2. 渲染 HTML 模板并传递数据
    context_data = {'page_title': '首页', 'message': '欢迎使用 Django!'}
    return render(req, 'home.html', context_data)

    # 3. 重定向到另一个 URL
    # return redirect('/about/')

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。