第1章：初见Django

1.2 Django环境搭建

Python环境要求

Django 5.x 对Python版本有特定要求。 推荐版本：Python 3.12+，性能更好且支持最新特性。目前最高版本是Python 3.12.10(2025年4月18日发布)。

检查Python版本

# 检查Python版本
python --version
# 或
python -V

# 输出示例
Python 3.12.10

如果你的系统Python版本过低，建议使用以下方法安装新版本：

Windows用户：

• 访问 windows版本下载地址 下载最新版本
• 或使用 Chocolatey：choco install python

macOS用户：

• 使用 Homebrew：brew install python@3.12
• 或从官网下载安装包

Linux用户：

# Ubuntu/Debian
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-pip

# CentOS/RHEL
sudo dnf install python3.12 python3.12-venv python3.12-pip

虚拟环境创建

虚拟环境可以为每个项目创建独立的Python环境，避免依赖包冲突。

使用venv创建虚拟环境

# 创建虚拟环境
python -m venv django_env

# Windows激活
django_env\Scripts\activate

# macOS/Linux激活
source django_env/bin/activate

# 激活后，命令提示符会显示虚拟环境名称
(django_env) $

虚拟环境管理

# 查看已安装的包
pip list

# 升级pip到最新版本
python -m pip install --upgrade pip

# 退出虚拟环境
deactivate

# 删除虚拟环境（直接删除文件夹）
rm -rf django_env  # Linux/macOS
rmdir /s django_env  # Windows

使用conda（可选）

如果你使用Anaconda或Miniconda：

# 创建conda环境
conda create -n django_env python=3.12

# 激活环境
conda activate django_env

# 退出环境
conda deactivate

Django 5.x 安装

确保虚拟环境已激活，然后安装Django。

安装最新版本

# 安装最新Django版本
pip install django

# 安装特定版本
pip install django=<版本号>

# 验证安装
python -m django --version
# 输出示例：5.0.1

安装额外依赖

根据项目需要，可能需要安装额外的包。或者等到使用时再安装。 最好根据自己的使用习惯，积累一些常用的安装包进行批量安装。

# 数据库驱动
pip install psycopg2-binary  # PostgreSQL
pip install mysqlclient      # MySQL
pip install cx_Oracle        # Oracle

# 开发工具
pip install django-debug-toolbar  # 调试工具栏
pip install django-extensions     # Django扩展

# 生产环境
pip install gunicorn         # WSGI服务器
pip install whitenoise       # 静态文件服务

开发工具推荐

代码编辑器/IDE

1. Visual Studio Code

   • 轻量级且功能强大
   • 丰富的插件生态
   • 推荐插件：
     • Python
     • Django
     • Python Docstring Generator
     • GitLens

2. AI IDE 在中国大模型主要是Deepseek、通义千问等。

   • 字节跳动 Trae
   • 腾讯 CodeBuddy
   • Qoder

3. PyCharm Professional

   • 功能最全面的Django IDE
   • 内置Django支持
   • 强大的调试功能
   • 数据库集成

VSCode Django开发配置

创建 .vscode/launch.json（调试配置）：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Django",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/manage.py",
            "args": [
                "runserver"
            ],
            "django": true,
            "justMyCode": true
        }
    ]
}

数据库管理工具

强烈推荐免费客户端软件，可以管理MySQL、PostgreSQL、Sqlite等数据库。 https://www.heidisql.com/

项目依赖管理

requirements.txt

创建 requirements.txt 文件管理项目依赖：

# 生成依赖文件
pip freeze > requirements.txt

# 安装依赖
pip install -r requirements.txt

示例 requirements.txt：

Django==5.0.1
psycopg2-binary==2.9.7
Pillow==10.0.1
django-debug-toolbar==4.2.0

开发和生产环境分离

创建不同的依赖文件：

requirements/base.txt：

Django==5.0.1
Pillow==10.0.1

requirements/dev.txt：

-r base.txt
django-debug-toolbar==4.2.0
django-extensions==3.2.3
ipython==8.15.0

requirements/prod.txt：

-r base.txt
gunicorn==21.2.0
whitenoise==6.5.0

安装方式：

# 开发环境
pip install -r requirements/dev.txt

# 生产环境
pip install -r requirements/prod.txt

环境验证

进入虚拟环境后，验证安装：

python -V
> Python 3.12.10
python -m django --version
> 5.2.6

常见问题解决

1. pip安装速度慢

# 使用国内镜像源
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple django

# 或配置永久镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

2. 权限错误

# macOS/Linux使用用户安装
pip install --user django

# 或使用sudo（不推荐）
sudo pip install django

小结

现在你已经成功搭建了Django开发环境：

1. ✅ 安装了Python 3.12+
2. ✅ 创建了虚拟环境
3. ✅ 安装了Django 5.x
4. ✅ 配置了开发工具
5. ✅ 设置了依赖管理

下一篇

我们将创建第一个Django项目，开始实际的Django开发之旅！
1.3 第一个Django项目 →

目录

返回课程目录