1.Django框架基础搭建与基础目录结构

Django 项目创建指南

本指南将详细介绍如何创建和启动一个基本的 Django 项目，并说明项目中的关键文件。

1. 项目创建命令

使用以下命令在当前目录下创建一个新的 Django 项目：

1
django-admin startproject 项目名称（请使用英文）

2. 设置允许访问的 IP

为了允许外部设备访问您的开发服务器，您需要修改项目的设置。

打开项目目录下的 settings.py 文件，找到 ALLOWED_HOSTS 设置（通常是一个空列表），将其修改为：

1
ALLOWED_HOSTS = ['*']

'*' 表示允许所有 IP 地址访问。在生产环境中，您应该将其修改为允许访问的特定域名或 IP 地址。

3. 项目启动命令

在项目根目录下（包含 manage.py 文件的目录）运行以下命令来启动 Django 的开发服务器：

1
python manage.py runserver 0.0.0.0:8000
  • manage.py: Django 项目的管理工具。
  • runserver: 运行开发服务器的命令。
  • 0.0.0.0:8000: 指定服务器监听所有可用的网络接口（0.0.0.0）和端口号（8000）。

4. 关键文件说明

一个标准的 Django 项目包含以下关键文件和目录：

  • manage.py:
    项目的主要入口文件，一个命令行工具，用于与 Django 项目进行交互，执行如数据库迁移、创建超级用户等管理任务。
  • settings.py:
    项目的全局配置文件，包含数据库连接、应用注册、中间件设置、模板配置、静态文件路径等所有重要配置项。
  • asgi.py:
    项目的 ASGI (Asynchronous Server Gateway Interface) 配置文件，用于支持异步功能，如 WebSocket。在部署异步应用时使用。
  • urls.py:
    项目的 URL 配置文件，负责将用户请求的 URL 路由到相应的视图函数或类。
  • wsgi.py:
    项目的 WSGI (Web Server Gateway Interface) 配置文件，用于支持同步的 Web 请求。在部署同步 Web 应用时使用。

5. 自定义启动脚本 (run.py)

为了简化项目启动过程，您可以创建一个自定义的 Python 脚本 run.py 放在项目根目录下。运行 python run.py 即可启动开发服务器。

以下是 run.py 文件的内容及其说明：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
import subprocess
import sys
import os

# 获取当前脚本所在目录（通常是项目根目录）
BASE_DIR = os.path.dirname(os.path.abspath(__file__))
# 构建 manage.py 脚本的完整路径
manage_py = os.path.join(BASE_DIR, 'manage.py')
# 获取当前正在使用的 Python 解释器路径
python_exe = sys.executable

# 定义服务器监听的 IP 地址和端口号
port = 8000
IP = '0.0.0.0' # 监听所有可用的网络接口

# 构建执行 'python manage.py runserver IP:PORT' 命令所需的参数列表
cmd = [python_exe, manage_py, 'runserver', f'{IP}:{port}']

# 使用 subprocess 模块执行命令
subprocess.run(cmd)

通过运行这个 run.py 脚本，您可以方便地使用当前 Python 环境和项目下的 manage.py 文件来启动开发服务器，无需手动输入完整的 python manage.py runserver 命令并指定 IP 和端口。