《Deer Social 项目启动与配置指南》

1. 项目的目录结构及介绍

Deer Social 是一个开源项目，其目录结构如下：

deer-social/
├── .gitignore          # 忽略文件列表
├── .env.example        # 环境变量示例文件
├── README.md           # 项目说明文件
├── license             # 项目许可证文件
├── requirements.txt    # 项目依赖列表
├── manage.py           # Django 管理脚本
├── deer_social/        # 项目主目录
│   ├── __init__.py     # 初始化文件
│   ├── settings/       # 配置目录
│   │   ├── __init__.py # 初始化文件
│   │   ├── base.py     # 基础配置文件
│   │   ├── dev.py      # 开发环境配置文件
│   │   ├── prod.py     # 生产环境配置文件
│   │   └── local.py    # 本地开发配置文件
│   ├── urls/           # URL 配置目录
│   │   ├── __init__.py # 初始化文件
│   │   └── urls.py     # URL 配置文件
│   ├── wsgi/           # WSGI 配置目录
│   │   └── __init__.py # 初始化文件
│   ├── wsgi/           # WSGI 应用配置文件
│   ├── apps/           # 应用目录
│   │   ├── __init__.py # 初始化文件
│   │   ├── account/    # 账户应用目录
│   │   ├── social/     # 社交应用目录
│   │   └── ...         # 其他应用目录
│   └── static/         # 静态文件目录
│       ├── css/
│       ├── js/
│       └── images/
└── templates/          # 模板文件目录

• .gitignore: 指定 Git 忽略的文件和目录。
• .env.example: 环境变量示例文件，用于设置项目的环境变量。
• README.md: 项目说明文件，包含项目的基本信息和如何使用。
• license: 项目使用的许可证文件。
• requirements.txt: 项目的依赖包列表，用于安装项目所需的库。
• manage.py: Django 项目的管理脚本，用于运行各种命令，如启动服务器、数据库迁移等。
• deer_social: 项目主目录，包含项目的所有代码。

2. 项目的启动文件介绍

项目的启动主要通过 manage.py 脚本完成。以下是一些常用的启动命令：

• 启动开发服务器：python manage.py runserver
• 运行数据库迁移：python manage.py migrate
• 创建超级用户：python manage.py createsuperuser
• 收集静态文件：python manage.py collectstatic

3. 项目的配置文件介绍

Deer Social 项目的配置文件位于 deer_social/settings 目录中，包括以下文件：

• base.py: 包含所有环境的通用设置。
• dev.py: 开发环境的特定设置。
• prod.py: 生产环境的特定设置。
• local.py: 本地开发环境的特定设置。

通常情况下，开发者会根据当前环境选择相应的配置文件，并在 manage.py 或 WSGI 文件中指定。例如，开发环境中可能使用以下代码来指定配置文件：

import os
import sys

DJANGO_SETTINGS_MODULE = 'deer_social.settings.dev'

确保在启动项目之前正确配置了数据库、静态文件和其他相关设置。