在 Linux 系统中安装 Django 是 Web 开发的基础技能，本文将详细介绍在主流 Linux 发行版（如 Ubuntu/Debian 和 CentOS/RHEL）上安装 Django 的完整流程，包括环境准备、不同安装方式的选择、配置及常见问题解决，帮助开发者顺利完成搭建。
环境准备：安装 Python 和 pip
Django 是基于 Python 的 Web 框架，因此首先需要确保系统已安装 Python 及其包管理工具 pip，不同 Linux 发行版的包管理器不同，安装方式略有差异。
Ubuntu/Debian 系统
Ubuntu 和 Debian 默认通常已安装 Python，但版本可能较旧，建议安装 Python 3.8 及以上版本（Django 4.0+ 要求 Python 3.8+），执行以下命令更新系统并安装 Python 3 和 pip：
sudo apt update && sudo apt upgrade -y # 更新系统包列表 sudo apt install python3 python3-pip python3-venv -y # 安装 Python 3、pip 及虚拟环境工具
安装完成后,验证版本：
python3 --version # 检查 Python 版本（如 Python 3.10.6） pip3 --version # 检查 pip 版本（如 pip 23.0.1 from /usr/lib/python3/dist-packages/pip (python 3.10)）
CentOS/RHEL 系统
CentOS/RHEL 默认可能未安装 Python 3，需通过 EPEL 仓库获取，执行以下命令：
sudo yum update -y # 更新系统 sudo yum install epel-release -y # 安装 EPEL 仓库 sudo yum install python3 python3-pip python3-venv -y # 安装 Python 3、pip 及虚拟环境工具
验证版本：
python3 --version pip3 --version
创建虚拟环境：隔离项目依赖
为了避免不同项目间的 Python 包冲突，推荐使用虚拟环境隔离依赖，Python 内置的 venv 模块可快速创建轻量级虚拟环境。
创建项目目录
在合适位置创建项目文件夹（如 ~/django_project），并进入该目录：
mkdir ~/django_project && cd ~/django_project
创建虚拟环境
执行以下命令创建名为 venv 的虚拟环境（可自定义名称）：
python3 -m venv venv
该命令会在当前目录下生成 venv 文件夹，包含独立的 Python 解释器和 pip。
激活虚拟环境
激活虚拟环境后,终端提示符会显示环境名称，后续操作均在该环境中隔离进行：
source venv/bin/activate # Linux/Mac 激活命令 # 激活后提示符变为：(venv) user@hostname:~/django_project$
退出虚拟环境可执行 deactivate。
安装 Django：三种主流方式
虚拟环境激活后,可通过以下三种方式安装 Django，根据项目需求选择合适的方法。
使用 pip 安装最新稳定版
最常用的方式是通过 pip 从 PyPI（Python 包索引）安装最新稳定版 Django：
pip install Django # 安装最新版（如 Django 4.2.3）
安装完成后,验证 Django 版本：
python -m django --version # 注意：激活虚拟环境后，可直接使用 python 命令
安装指定版本
若项目需要兼容特定版本（如 Django 3.2），可通过 指定版本号：
pip install Django==3.2.25 # 安装 Django 3.2.25 稳定版
也可使用 >、< 等符号指定版本范围，pip install "Django>=4.0,<5.0" 安装 4.x 版本。
从源码安装（开发版）
若需参与 Django 开发或使用未发布的版本，可从 GitHub 克隆源码安装：
git clone https://github.com/django/django.git # 克隆源码 cd django pip install -e . # -e 表示以可编辑模式安装，修改代码后无需重新安装
验证安装：创建第一个 Django 项目
安装完成后,可通过创建项目验证 Django 是否正常工作。
使用 django-admin 创建项目
在虚拟环境中执行以下命令（项目名需符合 Python 命名规范，避免使用空格和特殊字符）：
django-admin startproject myproject # 创建名为 myproject 的项目
该命令会生成 myproject 目录，包含以下核心文件：
manage.py：项目管理脚本，用于运行开发服务器、数据库迁移等命令。myproject/：项目配置包，包含settings.py（项目设置）、urls.py（URL 路由）、wsgi.py（WSGI 应用配置）等。
启动开发服务器
进入项目目录并启动开发服务器：
cd myproject python manage.py runserver # 默认运行在 http://127.0.0.1:8000/
在浏览器访问 http://127.0.0.1:8000/，若看到 Django 欢迎页面（It worked!），则安装成功。
创建应用（可选）
Django 采用“应用模块化”设计，每个功能可拆分为独立应用，通过以下命令创建名为 blog 的应用：
python manage.py startapp blog
生成 blog 目录后，需在 myproject/settings.py 的 INSTALLED_APPS 中添加 'blog' 以启用应用。
常见问题与解决方案
pip 安装失败：权限问题
若提示 Permission denied，避免使用 sudo pip install（可能破坏系统环境），而是在虚拟环境中使用 pip：
# 确保虚拟环境已激活 source venv/bin/activate pip install Django # 无需 sudo
版本冲突：使用虚拟环境隔离
若系统中同时存在多个 Python 版本，可能导致 pip 调用错误，可通过 python3 -m pip 指定 Python 3 的 pip：
python3 -m pip install Django # 强制使用 Python 3 的 pip
开发服务器无法访问
若外部设备无法访问开发服务器,需修改 runserver 命令，绑定所有网络接口：
python manage.py runserver 0.0.0.0:8000 # 允许通过 IP 访问（如 http://192.168.1.100:8000/）
Django 未找到：检查虚拟环境
若提示 django-admin: command not found，可能是虚拟环境未激活或安装路径错误，确保激活虚拟环境后重新安装：
source venv/bin/activate pip install Django
在 Linux 系统中安装 Django 的核心步骤可归纳为：安装 Python 和 pip → 创建虚拟环境 → 使用 pip 安装 Django → 验证安装，通过虚拟环境隔离依赖可有效避免项目冲突，而灵活的版本选择和源码安装方式则能满足开发与生产环境的不同需求，掌握以上流程后，开发者可快速搭建 Django 开发环境，专注于 Web 应用的功能实现。
