[赫兹威客][Python开发教程] Django 基础命令解析：新手入门必备（附实操示例）

原创已于 2025-10-22 11:40:04 修改 · 781 阅读

28 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#python #django #赫兹威客 #赫兹工作室 #hzsystem

于 2025-09-17 19:13:26 首次发布

hertz system 专栏收录该内容

1 篇文章

订阅专栏

Python3.8

Python 是一种高级、解释型、通用的编程语言，以其简洁易读的语法而闻名，适用于广泛的应用，包括Web开发、数据分析、人工智能和自动化脚本

作为 Django 新手，最先接触的就是命令行工具—— 无论是创建项目、操作数据库，还是启动开发服务器，都需要通过命令完成。本文会按 “开发流程” 分类，讲解最常用的 Django 基础命令，搭配实战示例和避坑指南，帮你快速上手。

一、项目初始化命令：创建项目

django-admin startproject：创建 Django 项目

作用：生成一个完整的 Django 项目目录（包含配置文件、命令入口等）。

语法：django-admin startproject 项目名

示例（创建名为my_django的项目）

（1）在cmd中创建：

我新建了一个空的文件夹：

在这个目录下打开cmd:

激活我的conda环境：

输入命令：

django-admin startproject my_django

这样项目就创建好了：

生成的项目结构

my_django/ # 项目根目录

├── my_django/ # 项目核心配置目录

│ ├── __init__.py

│ ├── settings.py # 项目全局配置（数据库、应用、静态文件等）

│ ├── urls.py # 项目主路由（URL映射）

│ ├── asgi.py # ASGI协议配置（用于生产环境）

│ └── wsgi.py # WSGI协议配置（用于生产环境）

└── manage.py # 项目命令入口（日常开发核心）

在PyCharm中查看：

（2）在PyCharm终端创建：

在PyCharm中打开终端：

激活conda环境：

输入创建的命令：

django-admin startproject my_django

这样就创建好了：

避坑点

项目名不要用django或 Python 内置关键字（如test），否则会冲突；

若执行命令提示 “django-admin 不是内部命令”，检查：① 虚拟环境是否激活；② Django 是否安装（pip list查看）。

二、应用管理命令：创建APP

Django 用 “应用（App）” 拆分功能（如 “用户模块”“文章模块”），每个应用是独立的功能单元。

2.1 python manage.py startapp：创建应用

作用：生成一个应用目录（包含模型、视图、路由等文件）。

语法：python manage.py startapp 应用名

示例（创建 “文章模块” 应用article）

（1）在cmd中创建：

先切换到创建的django项目的根目录下：

输入出来app的命令：

python manage.py startapp article

这样就创建成功了：

生成的应用结构

article/ # 应用目录

├── __init__.py

├── admin.py # 应用Admin后台配置

├── apps.py # 应用基本信息

├── migrations/ # 数据库迁移文件（记录模型变更）

├── models.py # 数据模型（ORM核心）

├── tests.py # 单元测试

└── views.py # 视图函数（业务逻辑）

（2）在PyCharm终端创建：

PyCharm终端操作是和cmd一样的，切换到项目根目录后，直接输入命令就好了：

cd my_djanngo

python manage.py startapp article

2.2 关键步骤：注册应用

创建应用后，必须在settings.py中注册，否则 Django 无法识别该应用的模型、路由等。

打开my_django/settings.py，在INSTALLED_APPS列表中添加应用名：

INSTALLED_APPS = [

'django.contrib.admin',

'django.contrib.auth',

# ... 其他默认应用

'article', # 新增：注册article应用

]

三、数据库核心命令：数据迁移

Django 的 ORM（对象关系映射）允许用 Python 类（Model）操作数据库，无需写 SQL。以下命令是 Model 与数据库同步的核心。

3.1 python manage.py makemigrations：生成迁移文件

作用:检测 Model 的变更（如新增字段、修改字段类型），生成 “迁移文件”（记录变更内容，存放在应用的migrations/目录）。

语法:

# 为所有应用生成迁移文件

python manage.py makemigrations

# 只为指定应用生成迁移文件（推荐，避免冗余）

python manage.py makemigrations 应用名

示例（为article应用的 Model 生成迁移）

(1) 先在article/models.py中定义一个文章模型：

from django.db import models

class Article(models.Model):

    title = models.CharField(max_length=100, verbose_name="文章标题")

    content = models.TextField(verbose_name="文章内容")

    create_time = models.DateTimeField(auto_now_add=True, verbose_name="发布时间")

（2）执行以下命令，生成迁移文件：