大家好,我是小智!
Django 是一个高级的 Python Web 框架,它鼓励快速开发和干净、实用的代码设计。本文将教你如何从零开始在本地环境中安装 Django 并创建第一个项目。
1. 准备工作:确保安装 Python
在安装 Django 前,请确保已经安装了 Python(建议 3.8 及以上版本)。
1.1 检查 Python 是否已安装
打开终端验证python是否安装,输入以下命令:
python --version
若输出如下图,则表示安装成功。
1.2 如果没有安装 Python
请前往官网下载安装 -> [Python下载地址]https://www.python.org/
2. 创建虚拟环境(可选,但推荐)
使用虚拟环境可以避免不同项目间的依赖冲突。
创建虚拟环境
python -m venv .venv
激活虚拟环境
Windows:
venv\Scripts\activate.bat
macOS / Linux:
source venv/bin/activate
激活成功后,你会看到终端前面多出 (venv),说明当前处于虚拟环境中。
3. 安装 Django
在虚拟环境中,执行以下命令安装Django。
pip install django
检查安装是否成功。
django-admin --version
若输出类似下图,则表示安装成功。
3.1 Django REST framework 是必须安装的吗?
很多初学者在安装 Django 后会看到各种教程推荐安装 djangorestframework,那么它到底是不是必须的呢?
3.1.1 简单分辨
如果只是用 Django 写传统的网页应用(有视图、模板和 HTML 页面),不需要安装 djangorestframework。
如果打算开发移动端接口、小程序后端、Vue/React 前端对接的 RESTful API,那 安装 DRF 是非常推荐且几乎必需的。
3.1.2 什么是 Django REST framework?
Django REST framework(简称 DRF)是 Django 的一个第三方库,用于快速开发高质量的 Web API。它提供了:
序列化器(Serializers):把模型转换为 JSON 输出
视图集(ViewSets)和路由(Routers):轻松构建接口逻辑
权限、认证、分页等通用 API 机制
非常友好的可视化调试界面(浏览器访问 API 自动生成页面)
3.1.3 安装方式
如果你确定要开发 API,可以使用 pip 安装:
pip install djangorestframework
然后在 settings.py 中注册:
INSTALLED_APPS = [
...
'rest_framework',
]
4. 创建 Django 项目
通过 django-admin 工具来创建一个新的 Django 项目:
django-admin startproject mysite
这会生成如下目录结构:
5. 运行开发服务器
进入项目根目录并启动开发服务器:
cd mysite
python manage.py runserver
打开浏览器访问:
http://127.0.0.1:8000/
查看界面,成功启动截图如下:
6. 参考资料
[Django官方文档]https://docs.djangoproject.com/zh-hans/