news 2026/9/3 14:17:25

如何10分钟快速上手Django:从环境安装到运行第一个项目的完整入门教程

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
如何10分钟快速上手Django:从环境安装到运行第一个项目的完整入门教程

如何10分钟快速上手Django:从环境安装到运行第一个项目的完整入门教程

【免费下载链接】djangoThe Web framework for perfectionists with deadlines.项目地址: https://gitcode.com/GitHub_Trending/dj/django

Django 是一款基于 Python 的开源 Web 框架,素有“为有截止日期的完美主义者打造的 Web 框架”之称。这篇 Django 入门教程将带你完成 Django 环境安装,10 分钟内创建并运行你的第一个 Django 项目,无需任何前置经验。

Django 最大的特点是“电池齐全”(batteries included):路由、数据库、模板渲染、后台管理界面全部内置。对新手最友好的,莫过于注册一个模型后,Django 会自动生成一个功能完整的后台管理页面——下面这张就是 Django 自带的管理表单界面:

第一步:安装 Django 环境(2分钟)

前置条件

  • 已安装 Python 3(在终端输入python --version即可验证)
  • 无需单独安装数据库,Python 自带轻量级的 SQLite

一键安装命令

打开终端,推荐先创建一个虚拟环境隔离依赖:

python -m venv myenv source myenv/bin/activate # Windows 使用 myenv\Scripts\activate python -m pip install django

验证是否安装成功:

python -c "import django; print(django.get_version())"

能打印出版本号,说明 Django 安装成功。官方安装说明见 docs/intro/install.txt。

第二步:创建第一个 Django 项目(3分钟)

在任意目录下执行:

django-admin startproject mysite .

这条命令会立即生成一个标准项目骨架:

mysite/ ├── manage.py # 项目管理命令行工具(核心入口) ├── mysite/ │ ├── __init__.py │ ├── settings.py # 项目配置文件(数据库、中间件等都在这里) │ ├── urls.py # URL 路由配置 │ └── asgi.py / wsgi.py

创建项目后,manage.py是你未来最常用的工具,几乎所有 Django 管理命令都通过它执行。

第三步:运行第一个项目(2分钟)

python manage.py runserver

打开浏览器访问http://127.0.0.1:8000/,你会看到 Django 的欢迎页面。开发服务器由 runserver.py 实现,它具备自动重载能力:修改任意 Python 文件后,浏览器会立即看到效果,无需手动重启。

恭喜!你的第一个 Django 项目已经跑起来了 🎉

附赠:体验 Django 最强大的内置后台

Django 的隐藏福利是内置的 Admin 后台管理系统。你只需定义数据模型并注册,Django 就会自动生成增、删、改、查的完整管理界面。下面是教程中的后台列表页效果,支持筛选、批量操作:

而新增数据时的表单页面如下,关联数据可以直接在页面内联编辑:

这些功能零代码即可获得,正是 Django “快速交付”理念的体现。

新手常见问题速查

问题解决方法
django-admin: command not found确认已激活虚拟环境,或执行python -m django startproject mysite .
端口 8000 被占用python manage.py runserver 8080换一个端口
中文乱码确认终端使用 UTF-8 编码

下一步学习路线

  1. 完整官方教程(从安装到部署的 8 步教程):docs/intro/tutorial01.txt 起步,逐章推进到 docs/intro/tutorial08.txt
  2. 快速安装指南:docs/intro/install.txt
  3. 官方文档目录入口:docs/index.txt
  4. 跑一下项目自带的完整测试套件,感受 Django 的工程质量:python tests/runtests.py(见 tests/runtests.py)

按照本教程,你已经在 10 分钟内完成了 Django 环境安装并运行了第一个项目。接下来只需跟着官方教程,定义你的第一个数据模型,就能体验 Django 自动后台的完整威力。

【免费下载链接】djangoThe Web framework for perfectionists with deadlines.项目地址: https://gitcode.com/GitHub_Trending/dj/django

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/9/3 14:16:14

计量经济学与Stata应用:从核心概念到实战建模的完整指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/3 14:16:11

模糊控制在非线性系统中的应用:以板球系统仿真为例

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/3 14:13:54

OpenClaw 2.0 Multiplayer:自托管AI助手多人协作的边界隔离实践

如果有两个人要同时使用同一套自部署 AI 助手,会发生什么? 听起来很简单:多加一个会话窗口、多拉一个账号进来,好像就行了。但真正用过单人模式的人会立刻撞上一面墙——两个人的日程其实写进了同一份待办清单,A 让 A…

作者头像 李华
网站建设 2026/9/3 14:12:12

Spring Boot课表管理系统实战:教务场景落地指南

简介:本资源是一套基于Spring Boot的课表管理系统完整源码,面向计算机专业本科生、Java Web初学者及高校教务系统开发实践者,解决班级课表管理、调课申请、用户协同与数据批量导入等典型教学管理场景需求。压缩包共581个文件,涵盖…

作者头像 李华
网站建设 2026/9/3 14:07:56

51单片机+NRF24L01温湿度无线监测系统设计与实现

简介:本资源是一套基于51单片机与NRF24L01无线模块实现的一主一从温湿度多点监测系统完整工程,面向计算机、自动化、电子信息、物联网等专业在校学生及课程设计实践者,解决传统有线传感网络布线复杂、扩展性差的问题,适用于课程设…

作者头像 李华
网站建设 2026/9/3 14:07:37

从小米龙甲电池看手机电池安全:严苛测试到底测什么?

这次我们直接切进一个很多人关心的话题:手机电池的安全标准,到底该怎么看。小米龙甲电池的名称里带着“安全”标签,网上也有不少“严苛测试验证”的说法。但问题是,这些测试通常不会把完整过程放出来,普通用户看到的往…

作者头像 李华