Django 安装（完整教程）

为什么选择 Django？初学者的第一步

在 Python 生态中，Django 是一个非常受欢迎的 Web 框架。它被誉为“开发者的瑞士军刀”，因为功能全面、结构清晰，特别适合快速搭建中小型网站。无论是博客系统、内容管理平台，还是企业内部管理系统，Django 都能胜任。

想象一下，你要建一座房子。如果从零开始挖地基、砌墙、装门窗，那会非常耗时。而 Django 就像是提供了一套预制的模块化组件——你只需要选择合适的部分，按照规范组装，就能快速建成一座稳固的房子。

对于初学者来说，Django 的“自带”功能减少了大量重复劳动。比如用户认证、数据库操作、URL 路由、表单处理，这些常见功能在 Django 中都已经封装好，你只需要调用即可。这大大降低了入门门槛，让你更专注于业务逻辑本身。

而“Django 安装”正是通往这座数字城堡的第一道门。只要这一步顺利，后续开发将顺畅无比。

环境准备：确保你的开发环境就绪

在安装 Django 之前，必须先确认你的系统环境满足基本要求。我们以主流操作系统为例，说明前置条件。

Python 版本要求

Django 支持 Python 3.8 到 Python 3.12，建议使用 Python 3.10 或更高版本。低版本可能存在兼容性问题，甚至无法安装最新版 Django。

你可以通过以下命令检查当前 Python 版本：

python --version

输出示例：Python 3.10.12

如果系统未安装 Python，或版本过低，请前往 python.org 下载安装包。安装时务必勾选“Add Python to PATH”选项，否则命令行无法识别 python 命令。

✅ 提示：如果你同时安装了 Python 2 和 Python 3，建议使用 python3 命令来明确指定版本，避免混淆。

安装 pip 包管理工具

pip 是 Python 的官方包管理器，用来安装、升级和卸载第三方库。大多数现代 Python 安装包都会自带 pip。

检查 pip 是否可用：

pip --version

如果提示“不是内部或外部命令”，说明 pip 未安装或未加入环境变量。

解决方法：使用官方脚本安装：

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

安装完成后，再次运行 pip --version，应能看到类似输出：pip 23.2.1 from /usr/lib/python3.10/site-packages/pip (python 3.10)

使用 pip 安装 Django：最推荐的方式

现在我们正式进入“Django 安装”的核心环节。推荐使用 pip 安装，因为它简单、可靠，且能自动处理依赖关系。

执行安装命令

在终端中运行以下命令：

pip install django

这条命令会从 PyPI（Python Package Index）下载 Django 及其所有依赖项，并安装到你的 Python 环境中。

💡 注：如果提示权限不足，可尝试添加 --user 参数，将包安装到用户目录：
pip install django --user

验证安装是否成功

安装完成后，验证 Django 是否安装成功：

django-admin --version

预期输出：4.2.7（具体版本号可能略有不同）

如果看到版本号，说明安装成功！此时你已经可以创建项目了。

创建第一个 Django 项目：从零开始

安装完成 Django 后，下一步就是创建你的第一个项目。这一步就像在空地上画出房屋的轮廓。

使用 django-admin 创建项目

在你希望存放项目的目录中打开终端，执行：

django-admin startproject mysite

这里 mysite 是你的项目名称，可以替换成你喜欢的名字，如 blog_project、company_website 等。

📌 注意：项目名称不要使用中文或特殊字符，避免编码问题。

执行后，会生成如下文件结构：

mysite/
├── manage.py
├── mysite/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── asgi.py
└── db.sqlite3

manage.py：项目管理脚本，所有 Django 命令都通过它执行。
mysite/ 目录：项目的配置文件集合。
settings.py：项目的核心配置文件，包含数据库、静态文件、安全设置等。
urls.py：URL 路由配置。
db.sqlite3：默认的 SQLite 数据库文件，用于存储数据。

启动开发服务器：看看你的 Django 项目是否正常运行

Django 提供了一个内置的开发服务器，无需额外配置即可快速预览项目。

启动服务器

进入项目目录：

cd mysite

然后运行：

python manage.py runserver

你会看到类似输出：

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 17 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
January 05, 2025 - 14:23:58
Django version 4.2.7, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

访问本地网页

打开浏览器，访问 http://127.0.0.1:8000/，你应该会看到 Django 的欢迎页面：

“Congratulations on your first Django-powered website.”

这表示你的 Django 安装和项目创建都成功了！

✅ 小贴士：如果你看到“无法访问”或“连接被拒绝”，请检查是否在正确的目录中运行 runserver，或端口是否被占用。

常见问题排查：安装过程中的“拦路虎”

即使按照步骤操作，也可能遇到一些常见问题。以下是一些高频问题及解决方案。

问题现象	可能原因	解决方案
`django-admin` 命令不存在	pip 安装失败或未加入环境变量	重新安装 pip，或使用 `python -m pip install django`
`PermissionError: [Errno 13]`	权限不足	添加 `--user` 参数，或使用虚拟环境
`ModuleNotFoundError: No module named 'django'`	Django 未正确安装	检查 `pip install django` 是否执行成功
服务器启动失败，提示端口占用	8000 端口已被其他程序占用	更改端口：`python manage.py runserver 8080`
无法访问 `127.0.0.1:8000`	防火墙或网络设置拦截	检查本地防火墙，或尝试 `http://localhost:8000`

🛠️ 推荐做法：使用虚拟环境（virtual environment）来隔离项目依赖，避免全局污染。虽然本次教程未涉及，但强烈建议后续学习。

总结：Django 安装，是通往 Web 开发的钥匙

今天，我们完成了从环境准备到项目运行的完整流程。你已经成功完成了“Django 安装”这一步，这意味着你已经具备了开发 Web 应用的基础能力。

Django 的强大不仅在于它功能丰富，更在于它“开箱即用”的体验。从创建项目、启动服务器，到看到欢迎页面，整个过程不到十分钟，却为你打开了一个全新的世界。

接下来，你可以尝试：

创建一个简单的“我的第一个应用”（python manage.py startapp myapp）
编写视图函数和模板
配置 URL 路由
连接数据库并展示数据

每一步，都会让你更深入理解 Django 的工作原理。

记住：真正的编程能力，不是记住命令，而是理解背后的逻辑。当你在“Django 安装”这一步顺利通过时，其实你已经迈出了成为全栈开发者的重要一步。

继续前进吧，你的第一个 Django 项目，正在等待你去点亮。