Django 项目开发初学者指南(快速入门手册)

Django 项目开发初学者指南，涵盖从项目初始化到模板与静态资源配置的全过程，适合用作快速入门手册：

---

💡 Django 项目结构与初始化配置说明

---

✅ 一、创建 Django 项目与应用

# 安装 Django（如未安装）
pip install django

# 创建 Django 项目（如名为 myproject）
django-admin startproject myproject

# 进入项目目录
cd myproject

# 创建 Django 应用（如名为 myapp）
python manage.py startapp myapp

---

✅ 二、项目目录结构概览

myproject/
├── manage.py                  # 管理工具脚本
├── myproject/                 # 项目主配置目录
│   ├── settings.py            # 全局配置文件
│   ├── urls.py                # 全局路由配置
│   ├── wsgi.py / asgi.py      # 部署接口
│   └── __init__.py
├── myapp/                     # 新建的应用目录
│   ├── views.py               # 视图函数定义
│   ├── models.py              # 数据模型
│   ├── urls.py                # 应用内路由（需手动创建）
│   ├── admin.py               # 后台管理注册
│   ├── apps.py                # 应用配置
│   ├── migrations/            # 数据迁移目录
│   └── ...
├── templates/                 # 模板目录（需手动创建）
└── static/                    # 静态资源目录（需手动创建）

---

✅ 三、编写视图函数 myapp/views.py

from django.http import HttpResponse

def hello_view(request):
    return HttpResponse("Hello, Django!")

---

✅ 四、创建并配置应用路由 myapp/urls.py

（该文件需手动创建）

from django.urls import path
from . import views

urlpatterns = [
    path('hello/', views.hello_view),  # 访问路径 /myapp/hello/
]

---

✅ 五、配置全局路由 myproject/urls.py

from django.contrib import admin
from django.urls import path, include  # 引入 include 函数

urlpatterns = [
    path('admin/', admin.site.urls),
    path('myapp/', include('myapp.urls')),  # 指向 myapp 应用的路由
]

---

✅ 六、注册应用到全局配置 myproject/settings.py

找到 INSTALLED_APPS 并添加 'myapp'：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    ...
    'myapp',  # 注册新建应用
]

---

✅ 七、配置模板路径（用于 HTML 渲染）

在 settings.py 中找到 TEMPLATES，添加模板目录路径：

TEMPLATES = [
    {
        ...
        'DIRS': [BASE_DIR / 'templates'],  # 设置全局模板目录
        ...
    },
]

然后可在 templates/ 下创建 HTML 文件并使用 render() 渲染。

---

✅ 八、配置静态文件路径（用于 CSS、JS、图片）

在 settings.py 中添加或确认如下配置：

STATIC_URL = '/static/'
STATICFILES_DIRS = [BASE_DIR / 'static']  # 静态文件开发目录

你可以在 static/ 目录中放置 CSS、JS、图片等资源，模板中通过 {% load static %} 引用。

---

✅ 九、启动开发服务器

python manage.py runserver

打开浏览器访问：

• http://127.0.0.1:8000/myapp/hello/ → 返回 Hello, Django!
• http://127.0.0.1:8000/admin/ → 进入后台管理系统（需创建超级用户）

---

✅ 总结

步骤	文件	功能说明
创建项目与应用	django-admin startproject	初始化工程与功能模块
注册应用	settings.py	加入 INSTALLED_APPS
编写视图	views.py	响应 HTTP 请求
配置路由	urls.py（项目 + 应用）	设置访问地址映射
模板配置	templates/ + settings.py	渲染 HTML 页面
静态资源配置	static/ + settings.py	提供 CSS、JS、图片等前端资源

---