Moon 项目启动与配置教程

1. 项目目录结构及介绍

Moon 项目的目录结构如下所示：

moon/
├── app/              # 应用程序目录
│   ├── __init__.py   # 初始化文件
│   ├── main/         # 主模块
│   └── utils/        # 工具模块
├── config/           # 配置文件目录
│   └── settings.py   # 配置文件
├── migrations/       # 数据迁移目录
├── scripts/          # 脚本目录
├── static/           # 静态文件目录
│   ├── css/
│   ├── js/
│   └── images/
├── templates/        # 模板文件目录
│   └── base.html
├── tests/            # 测试目录
└── manage.py         # 管理脚本

• app/: 包含应用程序的核心代码，包括初始化文件、主模块和工具模块。
• config/: 存储配置文件，用于定义项目所需的配置信息。
• migrations/: 保存数据库迁移脚本。
• scripts/: 存储一些执行特定任务的脚本。
• static/: 存放静态文件，如 CSS、JavaScript 和图片。
• templates/: 存储项目的 HTML 模板文件。
• tests/: 存储自动化测试脚本。
• manage.py: 用于管理项目，如运行服务器、执行迁移等。

2. 项目的启动文件介绍

项目的启动文件是位于项目根目录下的 manage.py。这个文件提供了启动项目所需的命令行接口。以下是一些常用的启动命令：

python manage.py runserver  # 启动开发服务器
python manage.py migrate   # 运行数据库迁移
python manage.py shell     # 打开 Django shell

要启动项目，你可以使用以下命令：

python manage.py runserver

默认情况下，这将启动一个运行在本地的服务器，地址通常是 http://127.0.0.1:8000/。

3. 项目的配置文件介绍

项目的配置文件位于 config/ 目录下，名为 settings.py。这个文件包含了项目的所有配置信息，如数据库连接、静态文件设置、中间件和应用的配置等。

以下是一些常见的配置项：

# 数据库配置
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

# 静态文件配置
STATIC_URL = '/static/'

# 应用配置
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # 添加自定义应用
    'app.main',
]

# 中间件配置
MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

你可以根据项目的具体需求修改 settings.py 文件中的配置项，以满足不同的部署环境或功能需求。在修改配置后，重新启动项目使配置生效。