编辑“︁Django项目创建”︁

= Django项目创建 =

== 介绍 ==
'''Django项目创建'''是使用Django框架进行Web开发的第一步。一个Django项目是一个完整的Web应用程序容器，可以包含多个应用（apps）。项目提供全局配置，而应用则是项目中实现特定功能的模块。本指南将详细介绍如何创建Django项目，并解释其目录结构和关键文件。

== 准备工作 ==
在创建Django项目之前，请确保已安装以下内容：
* Python 3.6或更高版本
* pip（Python包管理器）
* 虚拟环境（推荐）

=== 安装Django ===
使用pip安装Django：
<syntaxhighlight lang="bash">
pip install django
</syntaxhighlight>

== 创建Django项目 ==
使用Django提供的命令行工具'''django-admin'''创建项目。基本语法如下：
<syntaxhighlight lang="bash">
django-admin startproject 项目名称
</syntaxhighlight>

例如，创建一个名为'''myproject'''的项目：
<syntaxhighlight lang="bash">
django-admin startproject myproject
</syntaxhighlight>

=== 项目目录结构 ===
执行上述命令后，将生成以下目录结构：
<pre>
myproject/
├── manage.py
└── myproject/
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py
</pre>

各文件的作用：
* '''manage.py'''：项目管理脚本，用于运行开发服务器、创建应用等。
* '''myproject/settings.py'''：项目配置文件，包含数据库、应用、中间件等设置。
* '''myproject/urls.py'''：URL路由配置文件。
* '''myproject/wsgi.py'''：WSGI（Web Server Gateway Interface）配置，用于生产环境部署。

== 运行开发服务器 ==
Django自带一个轻量级的开发服务器，可用于测试。进入项目目录并运行：
<syntaxhighlight lang="bash">
python manage.py runserver
</syntaxhighlight>

默认情况下，服务器运行在<code>http://127.0.0.1:8000/</code>。访问该URL将看到Django的欢迎页面。

=== 修改端口 ===
可以指定端口号运行服务器，例如使用8001端口：
<syntaxhighlight lang="bash">
python manage.py runserver 8001
</syntaxhighlight>

== 创建Django应用 ==
一个Django项目可以包含多个应用。使用以下命令创建应用：
<syntaxhighlight lang="bash">
python manage.py startapp 应用名称
</syntaxhighlight>

例如，创建一个名为'''blog'''的应用：
<syntaxhighlight lang="bash">
python manage.py startapp blog
</syntaxhighlight>

应用创建后，需将其添加到<code>settings.py</code>的'''INSTALLED_APPS'''列表中：
<syntaxhighlight lang="python">
INSTALLED_APPS = [
    ...
    'blog',
]
</syntaxhighlight>

=== 应用目录结构 ===
应用目录结构如下：
<pre>
blog/
├── __init__.py
├── admin.py
├── apps.py
├── migrations/
├── models.py
├── tests.py
└── views.py
</pre>

== 实际案例：创建一个简单的博客项目 ==
以下是一个简单的博客项目创建流程：

1. 创建项目：
<syntaxhighlight lang="bash">
django-admin startproject myblog
cd myblog
</syntaxhighlight>

2. 创建博客应用：
<syntaxhighlight lang="bash">
python manage.py startapp blog
</syntaxhighlight>

3. 编辑<code>myblog/settings.py</code>，添加应用：
<syntaxhighlight lang="python">
INSTALLED_APPS = [
    ...
    'blog',
]
</syntaxhighlight>

4. 运行开发服务器：
<syntaxhighlight lang="bash">
python manage.py runserver
</syntaxhighlight>

== 项目配置 ==
=== 数据库配置 ===
默认情况下，Django使用SQLite数据库。可以在<code>settings.py</code>中修改数据库配置：
<syntaxhighlight lang="python">
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}
</syntaxhighlight>

=== 静态文件配置 ===
静态文件（CSS、JavaScript等）需在<code>settings.py</code>中配置：
<syntaxhighlight lang="python">
STATIC_URL = '/static/'
STATICFILES_DIRS = [BASE_DIR / 'static']
</syntaxhighlight>

== 常见问题 ==
=== 项目与应用的区别 ===
* '''项目'''：整个Web应用程序的容器，包含全局配置。
* '''应用'''：项目中的功能模块，可重用。

=== 如何调试Django项目 ===
使用Django的日志功能和Python的<code>print()</code>语句进行调试。也可以在<code>settings.py</code>中设置<code>DEBUG = True</code>以显示详细错误信息。

== 总结 ==
本文介绍了Django项目的创建方法、目录结构、开发服务器运行以及应用创建。通过实际案例展示了如何搭建一个简单的博客项目。下一步可以学习Django的模型（Models）、视图（Views）和模板（Templates）以进一步开发功能。

[[Category:后端框架]]
[[Category:Django]]
[[Category:Django基础]]