如何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 编码 |
下一步学习路线
- 完整官方教程(从安装到部署的 8 步教程):docs/intro/tutorial01.txt 起步,逐章推进到 docs/intro/tutorial08.txt
- 快速安装指南:docs/intro/install.txt
- 官方文档目录入口:docs/index.txt
- 跑一下项目自带的完整测试套件,感受 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),仅供参考