从零开始安装 Django:新手友好指南

      大家好,我是小智!

Django 是一个高级的 Python Web 框架,它鼓励快速开发和干净、实用的代码设计。本文将教你如何从零开始在本地环境中安装 Django 并创建第一个项目。

1. 准备工作:确保安装 Python

      在安装 Django 前,请确保已经安装了 Python(建议 3.8 及以上版本)。

1.1 检查 Python 是否已安装

      打开终端验证python是否安装,输入以下命令:

python --version

      若输出如下图,则表示安装成功。

image

1.2 如果没有安装 Python

      请前往官网下载安装 -> [Python下载地址]https://www.python.org/


2. 创建虚拟环境(可选,但推荐)

      使用虚拟环境可以避免不同项目间的依赖冲突。

  1. 创建虚拟环境
python -m venv .venv
  1. 激活虚拟环境
  • Windows:
venv\Scripts\activate.bat
  • macOS / Linux:
source venv/bin/activate

激活成功后,你会看到终端前面多出 (venv),说明当前处于虚拟环境中。


3. 安装 Django

  1. 在虚拟环境中,执行以下命令安装Django。
pip install django
  1. 检查安装是否成功。
django-admin --version
  1. 若输出类似下图,则表示安装成功。

image

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

      这会生成如下目录结构:

image


5. 运行开发服务器

  1. 进入项目根目录并启动开发服务器:
cd mysite
python manage.py runserver
  1. 打开浏览器访问:
http://127.0.0.1:8000/
  1. 查看界面,成功启动截图如下:

image

6. 参考资料

[Django官方文档]https://docs.djangoproject.com/zh-hans/

posted @ 2025-06-18 20:07  努力赚钱的小智  阅读(318)  评论(0)    收藏  举报