Windows 下 Django 安装与验证全攻略

对于很多刚接触 Python 网页开发的朋友来说，在 Windows 上安装 Django 可能会遇到各种环境问题。今天，我将以一位老技术员的身份，带你一步步完成 Django 的安装与验证，确保你一次成功。

环境准备工作

在安装 Django 之前，我们需要先搭建好它的运行环境。就像盖房子需要先打好地基一样，Django 需要 Python 环境作为基础。

第一步：安装 Python

1. 下载 Python

   • 打开浏览器，访问 Python 官方网站
   • 点击 Downloads 菜单，选择 Windows 版本
   • 建议下载 Python 3.8 或更高版本，这些版本对 Django 支持更好

2. 安装 Python

   • 双击下载的安装文件
   • 重要：在安装界面底部，一定要勾选“Add Python to PATH”选项
   • 点击“Install Now”开始安装
   • 等待安装完成，关闭窗口

3. 验证 Python 安装

   • 按下键盘上的 Win + R 键
   • 输入 cmd 然后按回车
   • 在黑色窗口中输入：python --version
   • 如果显示类似“Python 3.9.7”的版本号，说明安装成功

第二步：安装 pip 工具

pip 是 Python 的包管理工具，我们用它来安装 Django。新版本的 Python 通常自带 pip，但我们还是确认一下：

1. 在命令提示符中输入：pip --version
2. 如果显示 pip 版本信息，说明已安装
3. 如果需要升级 pip，输入：python -m pip install --upgrade pip

Django 安装详细步骤

方法一：使用 pip 安装（推荐）

这是最简单、最常用的安装方法：

1. 打开命令提示符

   • 按 Win + R，输入 cmd，按回车
   • 或者直接在开始菜单搜索“命令提示符”

2. 安装 Django

   • 输入以下命令：pip install django
   • 按回车后，你会看到下载进度条
   • 等待安装完成，整个过程可能需要几分钟

3. 指定版本安装

   • 如果你想安装特定版本的 Django，可以使用：pip install django==3.2.10
   • 将“3.2.10”替换为你需要的版本号

方法二：使用虚拟环境安装（专业做法）

对于实际项目开发，我强烈建议使用虚拟环境，这样可以避免不同项目的包版本冲突：

1. 安装虚拟环境工具

   pip install virtualenv

2. 创建项目文件夹

   • 在你想存放项目的地方新建一个文件夹，比如“myproject”
   • 在命令提示符中进入这个文件夹：cd 文件夹路径

3. 创建虚拟环境

   python -m venv venv

   这会在当前文件夹创建一个名为“venv”的虚拟环境

4. 激活虚拟环境

   venv\Scripts\activate

   激活后，命令提示符前面会出现“(venv)”字样

5. 在虚拟环境中安装 Django

   pip install django

验证 Django 安装

安装完成后，我们需要确认 Django 是否真的安装成功了。

验证方法一：检查版本号

1. 在命令提示符中输入：python -m django --version
2. 如果显示版本号（如“3.2.10”），说明安装成功
3. 或者输入：django-admin --version

验证方法二：创建测试项目

这是最实际的验证方法，我们通过创建一个简单的 Django 项目来测试：

1. 创建项目

   django-admin startproject testproject

   这会在当前目录创建一个名为“testproject”的文件夹

2. 进入项目目录

   cd testproject

3. 运行开发服务器

   python manage.py runserver

4. 查看结果

   • 打开浏览器，输入地址：http://127.0.0.1:8000
   • 如果看到 Django 的欢迎页面（火箭图标），恭喜你！Django 安装成功

5. 停止服务器

   • 回到命令提示符窗口
   • 按 Ctrl + C 停止服务器运行

常见问题与解决方案

问题1：提示“python不是内部或外部命令”

• 原因：Python 没有添加到系统路径
• 解决：
  1. 卸载 Python
  2. 重新安装，确保勾选“Add Python to PATH”
  3. 或者手动添加 Python 安装目录到系统环境变量

问题2：pip 安装速度慢或失败

• 原因：网络连接问题
• 解决：
  1. 使用国内镜像源，如清华源：

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

  2. 或者使用阿里云镜像：

     pip install django -i https://mirrors.aliyun.com/pypi/simple/

问题3：权限不足错误

• 原因：Windows 用户权限限制
• 解决：
  1. 以管理员身份运行命令提示符
  2. 或者使用：pip install --user django

问题4：虚拟环境激活失败

• 原因：Windows 执行策略限制
• 解决：
  1. 以管理员身份打开 PowerShell
  2. 输入：Set-ExecutionPolicy RemoteSigned
  3. 选择“Y”确认

进阶配置建议

1. 配置数据库

Django 默认使用 SQLite，适合初学者。如果你需要更强大的数据库：

# 安装 MySQL 支持
pip install mysqlclient

# 安装 PostgreSQL 支持
pip install psycopg2

2. 安装常用扩展包

对于实际开发，你可能还需要：

# 静态文件处理
pip install pillow

# 环境变量管理
pip install python-dotenv

# REST API 开发
pip install djangorestframework

3. 配置开发工具

• 代码编辑器：推荐 VS Code 或 PyCharm
• 数据库工具：DBeaver 或 HeidiSQL
• API 测试：Postman 或 Insomnia

维护与更新

查看已安装包

pip list

更新 Django

pip install --upgrade django

生成依赖文件

pip freeze > requirements.txt

给新手的特别提示

1. 不要怕命令行：刚开始可能不习惯，但这是开发者的必备技能
2. 一步一步来：按照教程顺序操作，不要跳步
3. 备份重要数据：在操作前，确保重要文件已备份
4. 善用搜索引擎：遇到错误信息，直接复制到搜索引擎，通常能找到解决方案
5. 加入社区：Django 中文社区、Stack Overflow 都是解决问题的好地方

最后的验证测试

为了确保你完全掌握了 Django 安装，我建议你完成这个终极测试：

1. 创建一个新的虚拟环境
2. 在新环境中安装 Django
3. 创建一个名为“myblog”的项目
4. 运行开发服务器
5. 在浏览器中访问确认

如果所有这些步骤都能顺利完成，那么你已经成功跨入了 Django 开发的大门。

记住，每个开发者都会遇到环境配置问题，这是学习过程的一部分。多练习几次，你就会发现这些步骤变得自然而然。现在，你已经准备好开始你的 Django 开发之旅了，下一步可以尝试创建第一个应用，或者跟着官方教程做一个简单的投票系统。

如果在操作过程中遇到任何问题，不要犹豫，把错误信息记下来，按照我们今天讲到的方法一步步排查。祝你在 Django 的学习道路上顺利前行！