Django入门教程：搭建你的第一个Python网站

开篇：Django 是什么？能做什么？

你可能听说过 Python 是一门非常强大且易学的编程语言，而 Django 就是建立在 Python 之上的一个 Web 开发框架。你可以把它想象成一套工具箱，帮助你用 Python 快速地搭建出一个功能完整的网站。

Django 可以用来做什么呢？很多知名的网站都使用 Django 构建，比如 Instagram、Pinterest 和 Mozilla 的一些项目。它特别适合需要快速开发、结构清晰、有数据库操作需求的网站，比如博客系统、社交平台、电商后台等。

那么，今天我们将一步步带你走进 Django 的世界，从零开始，一起搭建属于你的第一个网站！

---

环境准备：安装与配置 Django 开发环境

在我们正式开始写代码之前，先来准备好开发所需的软件和工具。

步骤一：安装 Python

确保你的电脑已经安装了 Python。在命令行中输入以下命令查看：

python --version

如果你还没有安装 Python，请前往官网下载安装最新版本（推荐 Python 3.10 或以上）： 👉 https://www.python.org/downloads/

步骤二：安装 pip（包管理工具）

pip 是 Python 自带的包管理器，我们可以用它来安装 Django。运行以下命令查看是否已安装 pip：

pip --version

如果没有安装，可以按照提示进行安装。

步骤三：安装 Django

接下来，使用 pip 安装 Django：

pip install django

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

django-admin --version

如果输出了版本号，说明安装成功！

---

核心概念：理解 Django 的基本架构

在正式进入实战前，我们先了解几个重要的核心概念，这样你在后面学习的时候就不会一头雾水了。

1. MTV 模式（MVC 的变体）

Django 使用的是类似于 MVC 的设计模式，称为 MTV 模型：

• Model（模型）：负责数据存储，通常对应数据库。
• View（视图）：处理业务逻辑，接收请求，返回响应。
• Template（模板）：负责页面展示，也就是 HTML 页面。

小提示：Django 中的 “View” 实际上承担了控制器的功能，而“模板”才是真正的前端展示部分，这是常见的新手容易搞混的地方哦！

2. 应用（App） vs 项目（Project）

• 项目（Project）：是整个网站的总容器，包含多个应用。
• 应用（App）：是项目中的一个模块，比如博客、用户管理、评论系统等。

举个例子：你的网站是一个大房子，里面有很多房间（应用），而这个大房子就是项目。

3. URL 路由（URL Routing）

URL 路由就像电话号码本，告诉网站当你访问某个网页地址时，该去找哪个“视图函数”来处理这个请求。

---

实战项目：创建你的第一个 Django 网站

现在我们正式进入实战阶段！我们将一步步构建一个简单的网站，在主页显示一句话：“欢迎来到我的第一个 Django 网站！”。

第一步：创建项目

打开终端或命令行工具，输入：

django-admin startproject mysite

这会创建一个名为 mysite 的项目文件夹，目录结构如下：

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py

第二步：启动服务器

进入项目文件夹并启动服务器：

cd mysite
python manage.py runserver

你会看到类似下面的输出：

Starting development server at http://127.0.0.1:8000/

浏览器访问：http://127.0.0.1:8000/，你应该可以看到 Django 的默认欢迎页面。

第三步：创建一个应用

我们要为网站添加内容，所以要创建一个应用（App）。回到命令行，按下 Ctrl+C 停止服务器，然后输入：

python manage.py startapp hello

你会得到一个新目录 hello，里面有如下文件：

hello/
    migrations/
    __init__.py
    admin.py
    apps.py
    models.py
    tests.py
    views.py

第四步：编写第一个视图（View）

打开 hello/views.py 文件，输入以下代码：

from django.http import HttpResponse

def index(request):
    return HttpResponse("欢迎来到我的第一个 Django 网站！")

这段代码的意思是：当有人访问我们的网站时，服务器将返回一段文字。

第五步：设置 URL 路由

为了让用户可以通过网址访问我们的视图函数，需要设置 URL 路由。

打开 hello/urls.py 文件（如果不存在就手动创建），写入以下内容：

from django.urls import path
from . import views

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

接着打开项目的主路由文件 mysite/urls.py，添加对 hello 应用的引用：

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('hello.urls')),  # 添加这一行
]

第六步：注册应用

为了使 Django 知道你刚刚创建了一个应用，你需要注册它。打开 mysite/settings.py，找到 INSTALLED_APPS 列表，并加入 'hello'：

INSTALLED_APPS = [
    ...
    'hello',
]

第七步：再次启动服务器并查看效果

运行服务器：

python manage.py runserver

刷新浏览器，你会发现页面变成了我们写的那句话：

欢迎来到我的第一个 Django 网站！

🎉 成功啦！你的第一个 Django 网站就这样诞生了！

---

常见问题解答：初学者容易遇到的错误及解决方法

Q1：命令执行报错，说找不到 django-admin 或 python 不是内部命令？

A：请检查 Python 是否正确安装，并确认 pip 已被添加到系统路径。另外，有时要用 python3 来代替 python，或者重新安装 Django。

Q2：访问页面显示 "Page not found" ?

A：可能是 URL 配置写错了。检查 urls.py 文件中是否正确设置了路径；记得重启服务器后再次访问。

Q3：提示找不到 hello.urls 模块？

A：可能没有注册 app 或者路径书写有误。检查 INSTALLED_APPS 是否包含 'hello'，以及 urls.py 中拼写是否正确。

Q4：修改代码后页面没变化？

A：Django 在开发模式下会自动重载修改的代码，但有时候不会及时更新。建议先停止服务器再重新运行。

---

学习建议：下一步该学什么？

恭喜你完成了第一个 Django 项目！但这只是旅程的开始。接下来，你可以尝试学习以下内容来进一步提升技能：

1. 模板（Templates）

• 学习如何在 Django 中使用 HTML 模板渲染动态内容。
• 掌握变量、控制语句在模板中的使用方式。

2. 数据库模型（Models）

• 学会如何定义数据模型并与数据库交互。
• 了解数据库迁移（migrations）的操作方法。

3. 表单（Forms）

• 创建用户提交数据的界面。
• 处理表单数据的验证与保存。

4. 用户认证（Authentication）

• 添加登录、注册、权限控制等功能。

5. 部署网站

• 将你的网站发布到互联网上，让别人也能访问。
• 学习使用服务器如 Nginx + Gunicorn 搭配部署 Django。

---

结语

通过这篇教程，你已经掌握了 Django 的基础使用方法，并搭建了自己的第一个网站。不要小看这个简单的项目，它为你打开了 Web 开发的大门。随着学习的深入，你会发现 Django 的强大与灵活，也将会拥有更多能力去创造自己的想法。

记住一句话：动手写代码是最好的学习方式！

加油！未来你也可以成为优秀的 Python Web 开发者！🌟