如何创建你的第一个 Django 项目

af
281 阅读7分钟

从零基础到创建第一个 Django 项目：详细教程

在 Web 开发领域，Django 是一个功能强大且备受青睐的 Python 框架。它可以帮助开发者高效地构建复杂的 Web 应用程序。在本文中，我们将从最基础的 Python 安装开始，一步步教你创建第一个 Django 项目。

一、Python 的安装

（一）下载 Python

  1. Windows 用户：
    访问 Python 的官方网站（www.python.org/downloads/）。在网站上找到适合 Windows 系统的 Python 安装包。一般来说，我们推荐下载最新版本的 Python 3。例如，你可能会看到类似 “Python 3.11.5 for Windows” 的下载选项，点击下载。
  2. Linux 用户：
    对于基于 Debian 的系统（如 Ubuntu），可以在终端中使用以下命令来安装 Python：
sudo apt update
sudo apt install python3

对于基于 Red Hat 的系统（如 CentOS），可以使用以下命令：

sudo yum install python3

3. MacOS 用户：
同样在 Python 官方网站下载适用于 Mac 的 Python 安装包，然后双击安装。

（二）安装过程

  1. Windows 安装步骤：

    • 双击下载好的.exe 安装文件，启动安装向导。
    • 在安装过程中，有一个关键步骤是勾选 “Add Python to PATH” 选项。这个操作会将 Python 的安装路径添加到系统环境变量中，使得我们可以在命令行的任何位置轻松调用 Python。
    • 其余步骤按照默认设置一直点击 “Next” 即可完成安装。

  2. Linux 和 MacOS 安装完成后检查：
    安装完成后，可以在终端中输入python3 --version（对于某些 Linux 系统，如果默认 Python 版本就是 3，也可以使用python --version），如果看到类似 “Python 3.11.5” 这样的版本信息显示出来，就说明 Python 安装成功了。

二、安装 Django

Python 安装好之后，我们就可以安装 Django 了。打开命令行（在 Windows 中是命令提示符或 PowerShell，在 Linux 和 MacOS 中是终端），输入以下命令：

pip install django

这个命令会使用 Python 的包管理工具 pip 从 Python 软件包索引（PyPI）下载并安装 Django。安装完成后，可以通过以下命令检查 Django 的版本：

python -m django --version

如果安装成功，会显示当前安装的 Django 版本号，比如 “5.1.3”。

image.png

三、创建 Django 项目

  1. 打开命令行终端，使用cd命令切换到你想要创建 Django 项目的目录。例如，如果你想在用户目录下创建项目，可以在终端中输入cd ~（适用于 Linux 和 MacOS）或者cd %USERPROFILE%（适用于 Windows）。
  2. 运行以下命令创建一个新的 Django 项目：
django-admin startproject myproject

这里的 “myproject” 是项目名称，你可以根据自己的喜好进行修改。这个命令会在当前目录下创建一个名为 “myproject” 的项目文件夹，其内部结构如下：

（一）项目结构解读

  1. manage.py：这是一个命令行工具，是整个 Django 项目管理的核心入口。通过它，我们可以执行各种操作，比如启动开发服务器、创建数据库迁移、创建新的应用程序等。例如，要启动开发服务器，我们可以在项目目录下运行python manage.py runserver。

  2. myproject/（项目文件夹） ：

    • __init__.py：这是一个空文件，它的作用是将这个目录标记为一个 Python 包，这样 Python 就可以识别这个目录下的模块。
    • settings.py：这个文件包含了整个项目的配置信息。例如，数据库的配置（包括数据库类型、连接信息等）、安装的应用程序列表、中间件设置、静态文件和媒体文件的配置等。
    • urls.py：这是项目的 URL 配置文件。它定义了项目的 URL 路由规则，决定了不同的 URL 请求会被导向到哪个视图函数或者视图类进行处理。
    • wsgi.py：这个文件是用于部署项目到 WSGI（Web Server Gateway Interface）兼容的 Web 服务器的入口点。当我们将项目部署到生产环境时，服务器会通过这个文件来启动我们的 Django 应用。

四、运行开发服务器

在项目目录（即包含manage.py的目录）中，运行以下命令：

python manage.py runserver

运行成功后，你会在命令行看到类似以下的输出：

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

System check identified no issues (0 silenced).

You have 18 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.

December 07, 2023 - 15:34:11
Django version 4.2.4, using settings 'myproject.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

此时，打开你的浏览器，在地址栏中输入http://127.0.0.1:8000/，你会看到 Django 的默认欢迎页面，这表明你的项目已经成功启动了。

五、创建应用程序

Django 项目是由一个或多个应用程序组成的。我们来创建一个名为 “myapp” 的应用程序。在命令行中，确保在项目目录下（即包含manage.py的目录），运行以下命令：

python manage.py startapp myapp

这个命令会在项目目录下创建一个名为 “myapp” 的新文件夹，其结构如下：

（一）应用程序结构解读

  1. __init__.py：和项目目录中的__init__.py作用类似，将这个目录标记为一个 Python 包。
  2. admin.py：这个文件用于注册模型，以便在 Django 的管理后台中对模型进行管理。例如，如果你创建了一个用户模型，你可以在这个文件中注册它，然后在管理后台中对用户数据进行增删改查操作。
  3. apps.py：这是应用程序的配置文件，在这里可以定义应用程序的一些配置信息，比如应用程序的名称、标签等。
  4. models.py：这个文件用于定义应用程序的数据模型。数据模型是 Django 中用于与数据库交互的核心部分。例如，你可以定义一个用户模型，包括用户名、密码、邮箱等字段。
  5. tests.py：这个文件用于编写应用程序的测试代码。通过编写测试代码，可以确保我们的应用程序在不同情况下都能正常工作。
  6. views.py：这个文件包含处理 HTTP 请求并返回 HTTP 响应的函数或类。例如，你可以创建一个视图函数，接收用户的请求，从数据库中获取数据，然后返回一个包含数据的 HTML 页面给用户。

六、配置应用程序

  1. 在项目的settings.py文件中，找到INSTALLED_APPS列表，并将新创建的应用程序名称添加到这个列表中。修改后的INSTALLED_APPS可能如下所示：
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'myapp',
]

2. 在应用程序的views.py文件中，添加一个简单的视图函数。例如：

from django.http import HttpResponse

def hello_world(request):
    return HttpResponse("Hello, World!")

3. 在应用程序中创建一个urls.py文件，并添加以下内容：

from django.urls import path
from. import views

urlpatterns = [
    path('hello/', views.hello_world),
]

4. 在项目的urls.py文件中，包含应用程序的 URL 配置。修改后的项目urls.py文件可能如下所示：

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

urlpatterns = [
    path('admin/', admin.site.urls),
    path('myapp/', include('myapp.urls')),
]

七、再次测试应用程序

现在，再次运行开发服务器（如果之前已经在运行，可以使用CONTROL - C停止，然后重新运行python manage.py runserver）。在浏览器中输入http://127.0.0.1:8000/myapp/hello/，你应该会看到一个简单的页面，上面显示着 “Hello, World!”。

八、总结

通过以上步骤，我们从安装 Python 开始，逐步完成了第一个 Django 项目的创建，并创建和配置了一个简单的应用程序。Django 还有很多丰富的功能等待我们去探索，比如数据库操作、表单处理、用户认证等。希望这篇文章能为你在 Django 开发的道路上打下一个坚实的基础，祝你在开发之旅中取得更多的成果！

avatar
文章
阅读
粉丝