Django 安装（长文讲解）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在快速发展的 Web 开发领域，Django 作为 Python 后端框架的“扛鼎之作”，凭借其“电池包含”（Batteries Included）的设计理念，成为开发者构建高质量 Web 应用的首选工具。无论是初学者搭建第一个个人博客，还是中级开发者尝试企业级项目，Django 的安装与配置都是必须跨越的第一道门槛。本文将通过循序渐进的方式，结合实际案例与代码示例，帮助读者掌握 Django 安装的完整流程，并理解背后的核心逻辑。

环境准备：搭建 Django 的“数字土壤”

1. Python 环境的安装与验证

Django 是基于 Python 的框架，因此安装的第一步是确保本地已配置 Python 环境。

• 安装 Python
  访问 Python 官网 下载对应操作系统的安装包。以 Windows 为例，选择安装时勾选“Add Python to PATH”选项，这将使 Python 命令在终端中全局可用。
• 验证安装
  打开终端（Windows 使用 CMD 或 PowerShell，macOS/Linux 使用终端），输入以下命令：

  python --version  
  

  若输出类似 Python 3.10.6 的信息，则说明安装成功。

比喻解释：
Python 环境如同操作系统中的“数字土壤”，Django 就像一颗种子，必须扎根于健康的土壤才能茁壮成长。若土壤（Python 环境）存在问题，后续的 Django 安装将无法完成。

2. 虚拟环境的创建与管理

为避免项目间依赖冲突，建议为每个 Django 项目创建独立的虚拟环境。

• 安装虚拟环境工具
  使用以下命令安装 venv（Python 内置模块）：

  python -m pip install --upgrade pip  
  python -m venv my_django_env  
  

• 激活虚拟环境
  根据操作系统执行不同命令：

  # Windows  
  my_django_env\Scripts\activate  
  # macOS/Linux  
  source my_django_env/bin/activate  
  

  激活后，终端会显示环境名称（如 (my_django_env)），表明已进入隔离空间。

核心价值：
虚拟环境如同“数字工作区”，它将 Django 及其依赖项与其他项目完全隔离，避免版本混乱。

Django 安装：核心步骤与常见问题

1. 通过 pip 安装 Django

在激活的虚拟环境中，使用 pip 命令安装最新稳定版 Django：

pip install django  

若需指定版本（如 Django 4.1.7），可添加版本号：

pip install django==4.1.7  

2. 验证 Django 安装

安装完成后，通过以下命令检查 Django 版本：

python -m django --version  

若输出类似 4.1.7 的信息，则安装成功。

3. 解决常见安装问题

• 权限问题：若提示“权限被拒绝”，尝试以管理员身份运行终端（Windows）或添加 sudo 前缀（macOS/Linux）。
• 网络问题：若因网络限制无法下载依赖，可使用清华镜像加速：

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

Django 项目创建：从零到可运行的 Web 应用

1. 初始化项目

安装完成后，使用以下命令创建首个 Django 项目：

django-admin startproject mysite  

此命令会生成如下目录结构：

mysite/  
├── manage.py  
└── mysite/  
    ├── __init__.py  
    ├── settings.py  
    ├── urls.py  
    └── wsgi.py  

• manage.py：项目管理工具，用于运行服务器、数据库迁移等操作。
• settings.py：项目配置文件，包含数据库、中间件、静态文件路径等核心参数。

2. 启动开发服务器

进入项目根目录后，执行：

python manage.py runserver  

默认情况下，服务器将在 http://127.0.0.1:8000 启动。访问该地址，若显示“Congratulations!”页面，则表示项目成功运行。

3. 配置与扩展

示例：创建第一个应用

在项目目录中，使用以下命令创建名为 polls 的应用：

python manage.py startapp polls  

随后在 settings.py 中注册应用：

INSTALLED_APPS = [  
    ...  
    'polls',  
]  

示例：编写视图与 URL 配置

在 polls/views.py 中定义视图：

from django.http import HttpResponse  

def index(request):  
    return HttpResponse("Hello, Django!")  

在 polls/urls.py 中配置路由：

from django.urls import path  
from . import views  

urlpatterns = [  
    path('', views.index, name='index'),  
]  

最后，在项目主 urls.py 中包含应用路由：

from django.urls import include, path  

urlpatterns = [  
    path('polls/', include('polls.urls')),  
    ...  
]  

重启服务器后，访问 http://127.0.0.1:8000/polls/ 即可看到自定义响应。

进阶技巧：优化开发流程

1. 使用 requirements.txt 管理依赖

通过以下命令生成依赖列表：

pip freeze > requirements.txt  

新环境部署时，仅需执行：

pip install -r requirements.txt  

2. 数据库配置优化

默认 SQLite 数据库适合开发阶段，生产环境建议替换为 PostgreSQL 或 MySQL。修改 settings.py 中的 DATABASES 配置：

DATABASES = {  
    'default': {  
        'ENGINE': 'django.db.backends.postgresql',  
        'NAME': 'mydatabase',  
        'USER': 'myuser',  
        'PASSWORD': 'mypassword',  
        'HOST': 'localhost',  
        'PORT': '',  
    }  
}  

结论与展望

通过本文的详细步骤，读者已掌握 Django 安装、环境配置及项目创建的核心流程。Django 的“快速启动”特性使其成为 Web 开发的理想选择，而虚拟环境与依赖管理工具的使用，则为后续复杂项目奠定了坚实基础。

对于中级开发者，建议进一步探索 Django 的中间件机制、ORM 模型设计及 REST API 开发，以解锁框架的全部潜力。无论你是刚入门的编程爱好者，还是寻求高效工具的专业开发者，Django 都能提供灵活且强大的支持——这正是其“Django 安装”后的真正价值所在。

附录：常见问题速查表
| 问题描述 | 解决方案 |
|----------|----------|
| 安装时提示“Module not found” | 检查虚拟环境是否激活 |
| 服务器启动失败 | 删除 pyc 文件并重启 |
| 跨版本依赖冲突 | 使用 pip install --force-reinstall |

通过本文的系统化指导，读者可将 Django 安装从“挑战”转化为“机遇”，开启属于自己的 Web 开发之旅。