Django学习之旅––第2课：Django项目与应用创建

从零开始打造项目平台：创建你的Django项目骨架

今天我们将正式启动你的项目骨架，步入Django项目与应用创建的神奇世界。这一步不仅会教你如何构建项目的核心框架，还将帮你理解Django中的项目与应用是如何协同工作的。让我们一起探索吧！

1. 核心概念：项目 vs 应用

在Django中，项目和应用是两个核心概念，它们分别扮演不同的角色。

• 项目（Project）：整个网站的容器，比如你的平台 my_side_hustle，包含全局配置，如数据库设置和URL路由。
• 应用（App）：独立的功能模块，比如用户管理 users 或服务展示 services。每个应用应聚焦于单一功能。
• 类比：
  • 项目 ≈ 一家公司
  • 应用 ≈ 公司里的部门（如财务部、市场部）

2. 创建你的项目

2.1 生成项目骨架

在终端中（确保虚拟环境已激活），执行以下命令：

# 进入上节课的目录（如my_side_hustle）
cd my_side_hustle

# 创建Django项目（注意末尾的`.`表示当前目录）
django-admin startproject freelance_portal.

关键点：末尾的.会让项目直接在当前目录创建，避免嵌套多层文件夹。

2.2 目录结构解析

运行上述命令后，你会看到如下目录结构：

my_side_hustle/
│
├── freelance_portal/ # 项目配置目录
│   ├── __init__.py
│   ├── settings.py # 全局设置（数据库、应用注册等）
│   ├── urls.py # 全局URL路由
│   ├── asgi.py # 异步服务器入口（暂不用）
│   └── wsgi.py # 传统服务器入口（部署用）
│
├── venv/ # 虚拟环境目录（上节课创建）
└── manage.py # 项目管理脚本（启动服务器、迁移等）

3. 创建第一个应用（以主页为例）

3.1 生成App

在终端执行：

python manage.py startapp homepage

这将新增一个 homepage 目录，结构如下：

homepage/
├── migrations/ # 数据库迁移文件（后续用）
├── __init__.py
├── admin.py # 后台管理配置
├── apps.py # 应用配置
├── models.py # 数据模型定义
├── tests.py # 测试代码
└── views.py # 业务逻辑处理

3.2 注册应用到项目

编辑 freelance_portal/settings.py，找到 INSTALLED_APPS 列表，添加你的应用：

INSTALLED_APPS = [
  'django.contrib.admin',
  'django.contrib.auth',
  'django.contrib.contenttypes',
  'django.contrib.sessions',
  'django.contrib.messages',
  'django.contrib.staticfiles',
  'homepage', # 新增这一行！
]

4. 启动开发服务器验证

在终端运行：

python manage.py runserver

访问 http://127.0.0.1:8000，应该依然看到火箭页面（因为尚未添加自定义页面）。

按 Ctrl+C 停止服务器。

5. 常见问题

• Q1：运行 runserver 时报端口冲突

  • 可能是之前服务器未正常关闭，改用其他端口：

  python manage.py runserver 8001
  

• Q2：修改代码后页面无变化

  • 检查是否保存了文件，服务器是否正常运行（终端无报错）。

今日成果：

• 理解项目与应用的差异
• 学会注册应用和启动开发服务器