练习 - 创建你的第一个项目

已完成

现在我们了解了 Django 的一些基本概念,让我们开始创建项目吧。

使用 Django-admin 创建项目

正如前面强调的,Django 项目是整个项目和我们创建的任何应用程序的容器。 让我们来创建项目。

在 Visual Studio Code 的“终端”窗口中,运行以下命令:

django-admin startproject helloproject .

重要

命令末尾的尾随句点非常重要。 它指示 django-admin 使用当前文件夹。 如果不加句点,它会另外创建一个子目录。

运行上述命令后,所选目录中现在应该有新项目。 在本例中,你会看到一个名为 helloproject 的新文件夹。

浏览项目结构

现在已创建了 Django 项目,接下来让我们查看结构来看看它包含的内容。

manage.py
helloproject/
    __init__.py
    asgi.py
    settings.py
    urls.py
    wsgi.py
  • 命令行实用工具 manage.py 是在每个 Django 项目中创建的。 它具有与 django-admin 相同的功能。下面的示例演示了当你在项目文件夹中并希望查看可用子命令时如何使用此实用工具。

    python manage.py help
    
  • helloproject 被视为项目的 Python 包。

  • init.py 是一个空文件,用于指示 Python 应将此目录看做一个包。

  • settings.py 包含所有设置或配置。

  • urls.py 包含项目中的 URL。

  • asgi.py 和 wsgi.py 用作 Web 服务器的入口点,具体取决于部署的服务器类型。

运行项目

现在已安装了 Django,创建了一个项目,而且我们检查了项目结构,是时候来确保项目正常工作了。

  1. 在 Visual Studio Code 的“终端”窗口中,输入以下代码来启动服务器。

    python manage.py runserver
    

    项目会执行系统检查并启动开发服务器。 将应为 http://localhost:8000 的开发服务器 URL 复制粘贴到你首选的浏览器中。 你应会看到 Django“恭喜”页面,上面有一张火箭起飞的图像。

  2. 暂时停止服务器,因为我们需要重新配置项目。 在“终端”窗口中,选择 Ctrl+C。

创建 Hello World 应用

我们了解了 Django 框架的基础知识,还检查了项目的文件夹结构。 现在可创建我们的第一个应用了! “Hello, world!”应用将帮助你了解如何创建应用及其如何与 Django 项目相互协调。

在“终端”窗口中,运行以下命令来创建应用。

python manage.py startapp hello_world

通过此命令,Django 将创建所需的文件夹和文件,现在应会显示如下结构。

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

向项目注册应用

由于应用和项目在 Django 中是分离的,因此你必须将应用注册到项目。 这是通过更新项目的 settings.py 内的 INSTALLED_APPS 变量,添加对应用配置类的引用来完成的。 配置类位于 apps.py 中,并且与项目的名称相同。 在我们的示例中,类将命名为 HelloWorldConfig

  1. 在 helloproject 中,打开 settings.py。

  2. 找到列表 INSTALLED_APPS,该列表应在第 33 行。

  3. 将以下内容添加到列表末尾的方括号 ([ ]) 内:

    'hello_world.apps.HelloWorldConfig',
    
  4. 更新的 INSTALLED_APPS 应如下所示:

    INSTALLED_APPS = [
        'django.contrib.admin',
        'django.contrib.auth',
        'django.contrib.contenttypes',
        'django.contrib.sessions',
        'django.contrib.messages',
        'django.contrib.staticfiles',
        'hello_world.apps.HelloWorldConfig',
    ]    
    
  5. 选择“文件”>“全部保存”,以保存所有文件。

恭喜! 现已创建第一个 Django 项目和应用。 接下来,创建路径和视图以添加某些功能。