新手实战指南：Django 项目结构与启动管理

霍格沃兹测试开发
24 阅读4分钟

在第一次接触 Django 时，很多同学都会被它的“重量感”劝退：

明明只是想写个接口，为什么要先创建一整套项目结构？

但这恰恰是 Django 的优势所在。 它不是一个“一个 .py 文件跑全场”的轻量框架，而是从第一天就把你拉进工程化开发的轨道。

这篇文章，完整整理了课堂视频中的核心内容，带你从 项目创建 → 服务启动 → 关闭与排错 → 项目结构拆解 一步步走清楚。

阅读目录

  • 一、Django 项目是如何创建的

  • 二、Django 服务如何启动与验证

  • 三、Django 服务关闭的两种方式

  • 四、新手最常见问题：端口被占用

  • 五、Django 项目整体结构一览（配图）

  • 六、核心文件逐个讲清楚

  • 七、为什么说 runserver 只适合开发环境

  • 八、本节内容小结

一、Django 项目是如何创建的？

在 Linux 环境中安装好 Django 后，系统会自动提供一个命令行工具：

django-admin

它是 创建 Django 项目的唯一入口。

创建项目的核心命令

django-admin startproject 项目名

例如：

django-admin startproject myset

执行完成后，会在当前目录下生成一个新的项目文件夹。

你可以通过：

ls

来确认项目是否创建成功。

二、Django 服务如何启动与验证？

项目创建完成后，第一件事一定是：把服务跑起来，确认环境没问题。

1、 启动开发测试服务

进入项目目录，执行：

python3 manage.py runserver

此时 Django 会：

  • 启动一个开发环境服务器

  • 默认监听 8000 端口

  • 仅用于本地开发与测试

终端中会看到类似输出：

Starting development server at http://127.0.0.1:8000/

2、 浏览器验证服务状态

在浏览器中访问：

http://127.0.0.1:8000

如果看到 Django 的欢迎页面（带动画的那个），说明：

  • 项目结构正确

  • Django 运行正常

  • 服务启动成功

3、 指定其他端口启动

如果 8000 端口不方便使用，也可以指定端口：

python3 manage.py runserver 5000

访问地址对应变为：

http://127.0.0.1:5000

三、Django 服务如何关闭？两种常见方式

方式一：最推荐（记得启动终端）

在运行 runserver 的终端中，直接按：

Ctrl + C

服务会立刻停止，端口释放。

方式二：端口被占 / 忘了在哪个终端启动

这是新手阶段非常高频的情况。

1、 查找端口占用进程

sudo lsof -i :8000

输出可能会有多行，重点找状态为 LISTEN 的那一行。

2、杀掉对应进程

kill -9 进程ID

然后重新执行 runserver 即可。

四、新手最常见问题：端口被占用怎么办？

当你启动服务时看到：

Error: That port is already in use

不要慌，这个问题本质只有两种原因：

  • 上一次 Django 服务没有正常关闭

  • 该端口被其他程序占用

解决思路固定不变：

  1. 用 lsof -i :端口号 查

  2. 找 LISTEN 状态

  3. kill 掉进程

  4. 重新启动服务

五、Django 项目整体结构一览

创建完成后的 Django 项目，结构大致如下：

myset/├── manage.py├── db.sqlite3└── myset/    ├── __init__.py    ├── settings.py    ├── urls.py    └── wsgi.py

六、Django 项目结构

graph LR    A[Django 项目] --> B[manage.py]    A --> C[db.sqlite3]    A --> D[项目同名文件夹]    D --> D1[__init__.py]    D --> D2[settings.py]    D --> D3[urls.py]    D --> D4[wsgi.py]

七、核心文件逐个讲清楚（新手重点）

Django 项目文件结构拆解图

1、 manage.py —— Django 的命令总入口

  • 所有 Django 子命令都从这里触发

  • runserver、migrate、createsuperuser 都依赖它

如果你忘了命令怎么写：

python3 manage.py

直接回车即可查看全部可用命令。

2、 db.sqlite3 —— 默认数据库文件

  • 新建项目时不存在

  • 第一次 runserver 时自动生成

  • Django 默认数据库

在实际项目中，后续通常会替换为 MySQL 或 PostgreSQL。

3、 项目同名文件夹（核心配置区）

  • __init__.py：Python 包标识

  • settings.py：项目配置核心文件

  • urls.py：主路由入口，所有请求先到这里

  • wsgi.py：正式上线时使用的 Web 网关配置

八、一个必须记住的结论

runserver 只适合开发和测试环境

  • 前台启动

  • 性能与安全性都不适合生产

  • 正式上线会采用更规范的启动方式

九、本节内容小结

  • Django 项目创建使用 django-admin startproject

  • 开发环境启动使用 python3 manage.py runserver

  • 服务关闭可通过 Ctrl + C 或 kill 进程

  • 项目结构中最重要的是：

  • manage.py（命令入口）

  • 项目同名文件夹（核心配置）

avatar
文章
阅读
粉丝