7 创建第一个Django项目

在上一篇中，我们完成了Django的环境搭建，确认了开发环境的正确配置。现在，我们将开始创建我们的第一个Django项目。这一过程将帮助你初步理解Django的项目结构和基本配置。

创建项目

在终端中，首先需要确保我们处在一个合适的工作目录下。在这里，我建议你创建一个名为projects的文件夹来存放接下来的项目：

mkdir ~/projects
cd ~/projects

接下来，我们将使用Django的命令行工具来创建一个新的项目。Django提供了django-admin startproject命令来帮助我们快速初始化项目。

假设我们要创建一个项目名为my_first_project，可以在终端中运行以下命令：

django-admin startproject my_first_project

运行后，你将看到在projects目录下生成了一个名为my_first_project的文件夹。现在，让我们来查看一下这个新创建的项目结构。

项目结构

进入my_first_project目录：

cd my_first_project

使用ls命令查看目录内容：

ls

你将看到如下的文件和目录结构：

my_first_project/
    manage.py
    my_first_project/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

文件和目录解释

• manage.py：这是一个命令行工具，它允许你与Django项目进行交互。你可以用它来运行开发服务器、创建应用、迁移数据库等.
• my_first_project/：这个目录与项目同名，包含了项目的配置文件，包括数据库配置、静态文件配置及其他设置。
  • __init__.py：这个文件是一个空文件，它告诉Python解释器，my_first_project目录是一个包。
  • settings.py：这是项目的主要配置文件，包含了数据库配置、应用配置等内容。
  • urls.py：这个文件用于设置项目的URL路由，将URL请求映射到对应的视图。
  • asgi.py：这个文件用于支持Asynchronous Server Gateway Interface（ASGI）应用，是处理异步请求的接口。
  • wsgi.py：这个文件用于支持Web Server Gateway Interface（WSGI）应用，是用于处理常规同步请求的接口。

运行开发服务器

在继续深入了解项目结构之前，我们可以先运行开发服务器，快速查看项目是否创建成功。确保你处于my_first_project的根目录下，然后执行以下命令：

python manage.py runserver

这将启动Django的开发服务器。你将看到类似以下的输出：

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

打开浏览器，访问http://127.0.0.1:8000/，如果看到输出“Welcome to Django!”的页面，那么你的项目就创建成功了！

配置settings.py

接下来，我们可以稍微修改settings.py文件，了解一些基本配置。打开settings.py，你会看到一系列配置。

# my_first_project/my_first_project/settings.py
# ...
DEBUG = True  # 启用调试模式
ALLOWED_HOSTS = []  # 允许的主机（在生产环境中需要配置）
# ...

在开发阶段，确保DEBUG设置为True。ALLOWED_HOSTS用于指定可以访问该项目的主机，在开发阶段可以保持为空，但请在生产环境中配置合适的值。

小结

在这一部分，我们创建了我们的第一个Django项目，并详细了解了项目的基本结构。同时，我们也启用了开发服务器，验证项目的创建。接下来的步骤将深入理解每个部分的功能，以便于后续开发的应用和扩展。

下一篇将会详细介绍Django项目的结构，帮助你更深入地理解这些文件和目录的作用。