[特殊字符] Django 常用命令

🚀 Django 常用命令大全：从开发到部署

        Django 提供了许多实用的命令，可以用于 数据库管理、调试、测试、用户管理、运行服务器、部署 等。
        本教程将详细介绍 Django 开发中最常用的命令，并提供 示例，帮助你更高效地使用 Django。

---

📌 1. Django 开发环境相关命令

✅ 1.1 创建 Django 项目

django-admin startproject 项目名称

• 作用：创建一个新的 Django 项目 {项目名称}，生成 settings.py、manage.py 等文件。
• 项目目录结构：

  myproject/
  ├── manage.py
  ├── {项目名称}/
  │   ├── __init__.py
  │   ├── settings.py
  │   ├── urls.py
  │   ├── asgi.py
  │   ├── wsgi.py
  

---

✅ 1.2 创建 Django 应用（App）

python manage.py startapp 应用名称

• 作用：在 myproject 项目下创建 {应用名称} 应用（App）。

• 应用目录结构：

  {应用名称}/
  ├── migrations/
  ├── __init__.py
  ├── admin.py
  ├── apps.py
  ├── models.py
  ├── tests.py
  ├── views.py
  

• 注意：创建 App 后，需要在 settings.py 中注册：

  INSTALLED_APPS = ['django.contrib.admin','django.contrib.auth','django.contrib.contenttypes','django.contrib.sessions','django.contrib.messages','django.contrib.staticfiles','myapp',  # ✅ 注册应用
  ]
  

---

📌 2. 运行服务器

✅ 2.1 启动 Django 服务器

python manage.py runserver

• 作用：启动 Django 内置的开发服务器（默认监听 127.0.0.1:8000）。

• 如果要修改端口：

  python manage.py runserver 8080
  

• 如果要监听所有 IP（适用于局域网调试）：

  python manage.py runserver 0.0.0.0:8000
  

---

📌 3. 数据库操作

✅ 3.1 生成数据库迁移文件

python manage.py makemigrations

• 作用：Django 检测 models.py 变更 并生成数据库迁移文件（不会真正修改数据库）。

✅ 3.2 应用迁移文件

python manage.py migrate

• 作用：执行 migrations/ 目录下的迁移文件，真正修改数据库。

✅ 3.3 显示所有迁移状态

python manage.py showmigrations

• 作用：显示哪些迁移已应用，哪些未应用。

✅ 3.4 还原迁移（回滚）

python manage.py migrate myapp 0001_initial  # 回滚到某个迁移版本
python manage.py migrate myapp zero  # 删除所有迁移

✅ 3.5 清空数据库（危险！）

python manage.py flush

• 作用：清除数据库中的所有数据（但不会删除表结构）。
• ⚠️ 注意：这个命令会 清空所有用户数据！

✅ 3.6 强制重新应用迁移（危险！） 

python manage.py migrate --fake 应用名称 zero
python manage.py migrate 应用名称

---

📌 4. Django Shell（交互式调试）

✅ 4.1 启动 Django Shell

python manage.py shell

• 作用：进入交互式 Python 环境，直接操作 Django ORM、查询数据库、调试代码。

✅ 4.2 使用 Django Shell 查询数据

from myapp.models import Chat# 查询所有 Chat 记录
chats = Chat.objects.all()
print(chats)# 创建新数据
new_chat = Chat.objects.create(user_id=1, title="测试对话")
print(new_chat.id)

✅ 4.3 启动 Django Shell 并支持 IPython

python manage.py shell_plus --ipython

• shell_plus（需要安装 django-extensions）：

  pip install django-extensions

  好处：
  • 自动加载所有 models.py
  • 更强的语法高亮
  • 更丰富的调试工具

---

📌 5. 用户管理

✅ 5.1 创建超级用户

python manage.py createsuperuser

• 作用：创建 Django 管理员账户，可用于 http://127.0.0.1:8000/admin/
• 示例：

  Username: admin
  Email: [e-mail]
  Password: ******
  

✅ 5.2 修改用户密码

python manage.py changepassword admin

• 作用：修改 admin 用户的密码。

✅ 5.3 查看所有用户

from django.contrib.auth.models import User
users = User.objects.all()
print(users)

---

📌 6. 测试 Django 应用

✅ 6.1 运行测试

python manage.py test 应用名称

• 作用：运行 myapp/tests.py 里的所有测试。

✅ 6.2 编写简单测试

在 tests.py 里：

from django.test import TestCase
from myapp.models import Chatclass ChatTest(TestCase):def test_create_chat(self):chat = Chat.objects.create(user_id=1, title="测试聊天")self.assertEqual(chat.title, "测试聊天")

然后运行：

python manage.py test

---

📌 7. 静态文件管理

✅ 7.1 收集静态文件

python manage.py collectstatic

• 作用：将 static/ 目录下的所有静态文件收集到 STATIC_ROOT 目录。

---

📌 8. 数据库备份与导入

✅ 8.1 导出数据库数据

python manage.py collectstatic

• 作用：将数据库数据导出为 JSON 格式。

✅ 8.2 导入数据库数据

python manage.py loaddata db.json

• 作用：从 db.json 重新导入数据。

---

📌 9. 生产环境相关

✅ 9.1 运行 Django 服务器（生产模式）

gunicorn myproject.wsgi:application --bind 0.0.0.0:8000

• 需要安装 gunicorn：

  pip install gunicorn
  

✅ 9.2 配置 ALLOWED_HOSTS

• 在 settings.py 里：

  ALLOWED_HOSTS = ["mywebsite.com", "127.0.0.1"]
  

---

🎯 结论

分类	常用命令
创建项目	startproject、startapp
数据库操作	makemigrations、migrate、flush、showmigrations
服务器	runserver
用户管理	createsuperuser、changepassword
Shell 调试	shell、shell_plus
测试	test
生产环境	collectstatic、gunicorn