Django作为一个高级Python Web框架，提供了丰富的命令行工具（manage.py）来帮助开发者快速完成项目开发、调试和部署等任务，这些命令涵盖了项目创建、应用管理、数据库操作、服务器启动等多个方面，熟练掌握它们能极大提升开发效率，以下从项目初始化、应用管理、数据库交互、服务器运行、静态文件处理、超级用户创建、密码重置、项目检查和迁移操作等维度,详细介绍Django的基本命令及其使用场景。
在项目初始化阶段，django-admin startproject projectname是创建Django项目的核心命令，其中projectname为项目名称，执行后会生成包含settings.py、urls.py等关键配置文件的目录结构，若使用PyCharm等IDE，可通过“New Project”选择Django模板自动完成此操作，创建项目后，需通过python manage.py runserver启动开发服务器，默认端口为8000，若需修改端口可添加--port参数（如--port 8080），或指定IP地址（如--ip 127.0.0.1），该命令仅用于开发环境，生产环境需配合Gunicorn、uWSGI等服务器使用。
应用管理是Django模块化开发的重要支撑，每个Django项目由多个应用（app）组成，通过python manage.py startapp appname可创建新应用，appname为应用名称，创建后需在settings.py的INSTALLED_APPS列表中注册应用，否则Django无法识别，应用创建后，可通过python manage.py app_label --list查看应用下的模型（需先定义模型并迁移），或使用python manage.py app_label --verbosity=2获取更详细的应用信息，删除应用时，需先从INSTALLED_APPS中移除,再删除应用目录及数据库中的相关表。
数据库操作是Django开发中的高频任务，在定义模型（models.py）后，需执行python manage.py makemigrations appname生成迁移文件（migrations/0001_initial.py），该文件记录了模型结构的变更，若未指定appname，则会为所有应用生成迁移文件，随后通过python manage.py migrate将迁移文件应用到数据库，创建或修改数据表，若需查看迁移历史，可运行python manage.py showmigrations appname，输出中[ ]表示未执行，[X]表示已执行，数据库初始化后，可通过python manage.py dbshell进入数据库命令行界面，直接执行SQL语句（需提前配置数据库连接参数）。
超级用户创建和密码重置涉及用户权限管理，通过python manage.py createsuperuser可创建管理员账户，按提示输入用户名、邮箱和密码（密码需满足复杂度要求），若需修改超级用户密码，可使用python manage.py changepassword username，按提示输入新密码两次，若忘记密码且无法通过changepassword修改，可直接在数据库中更新auth_user表的password字段（需使用Django的密码哈希算法，如make_password('newpassword')）。
静态文件处理和项目检查也是常用功能，Django开发服务器默认不处理静态文件，需通过python manage.py runserver --nostatic禁用静态文件服务，生产环境则需配置collectstatic命令：python manage.py collectstatic，该命令会将各应用中的静态文件（CSS、JS、图片等）收集到settings.py中STATIC_ROOT指定的目录，项目检查方面，python manage.py check用于验证项目配置是否正确，如--deploy参数会检查生产环境配置（如DEBUG是否为False、ALLOWED_HOSTS是否设置等），若应用出现异常，可通过python manage.py shell进入交互式Python环境,测试模型操作或调试代码。
迁移操作是模型变更后的必要步骤，当修改模型字段（如添加新字段、修改字段类型）后，需重新执行makemigrations生成迁移文件，再通过migrate更新数据库结构，若需回滚迁移，可使用python manage.py migrate appname migrationname，其中migrationname为迁移文件名（如0001_initial），若需删除未应用的迁移文件，可运行python manage.py squashmigrations appname migrationname,合并多个迁移文件为一个。
| 命令分类 | 具体命令 | 功能说明 |
|---|---|---|
| 项目初始化 | django-admin startproject | 创建Django项目 |
| python manage.py runserver | 启动开发服务器 | |
| 应用管理 | python manage.py startapp | 创建新应用 |
| python manage.py app_label --list | 查看应用下的模型 | |
| 数据库操作 | python manage.py makemigrations | 生成迁移文件 |
| python manage.py migrate | 应用迁移到数据库 | |
| python manage.py showmigrations | 查看迁移历史 | |
| python manage.py dbshell | 进入数据库命令行 | |
| 用户管理 | python manage.py createsuperuser | 创建超级用户 |
| python manage.py changepassword | 修改用户密码 | |
| 静态文件与检查 | python manage.py collectstatic | 收集静态文件 |
| python manage.py check | 检查项目配置 | |
| 迁移操作 | python manage.py squashmigrations | 合并迁移文件 |
相关问答FAQs
Q1: 执行python manage.py migrate时提示“no such table: auth_user”，如何解决？
A: 该错误通常是因为数据库中未创建Django内置的auth相关表，需确保已执行python manage.py migrate（不指定应用名，会迁移所有应用），包括auth、contenttypes等核心应用，若问题依旧，可能是数据库配置错误，检查settings.py中的DATABASES设置是否正确，并尝试删除数据库文件（SQLite）或数据库（MySQL/PostgreSQL）后重新迁移。
Q2: Django开发环境中如何修改静态文件路径？
A: 在settings.py中配置STATIC_URL（静态文件URL前缀）和STATICFILES_DIRS（静态文件存储目录）。
STATIC_URL = '/static/' STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')] # 项目根目录下的static文件夹
若需为应用单独配置静态文件，Django默认会在应用目录下查找static/appname/路径，无需额外配置，开发环境中，静态文件修改后会自动重载,无需重启服务器。
