橡皮擦，一個逗趣的互聯網高級網蟲，新的系列，讓我們一起進入 Django 世界，

已經完成的文章

• 滾雪球學 Python 第三輪，Python Web 之 Django 的世界
• 小手哆嗦一下，就能用 Python Django 實作一個微型博客系統
• Django 做個小后臺，細節在完善一點點，滾雪球學 Python 第三階段
• Django QuerySet 就學那么一點點，一點點就夠了
• 看完這篇博客，Python Django 你就學會一半了
• 讓我們一起開發【菜譜系統】吧，滾雪球學 Python 第三輪專案計劃
• 出現吧，Python Web 菜譜系統的首頁，不會前端技術，也能做
• 簡簡單單實作 Python Web 的登錄注冊頁面，還包含一半邏輯，
• Python Web 菜譜專案再次前進一步，從應用層了解內置用戶認證系統
• 菜譜系統小成階段，Python Web 領域終于攻占一個小山頭
• 銷售 小姐姐 給買家打分系統，用 Python Django 又整了一個花活
• 幫小姐姐打分系統的模型創建，滾雪球學 Python 第三輪第 12 篇
• 為了完成小姐姐安排的打分系統，又熬了一個小時的夜補充視圖與模板
• 打分吧！客服小姐姐，評分頁面與客戶總分頁面的 Django 實作

十五、django-admin 命令列工具

15.1 django-admin 和 manage.py 簡介

django-admin 是 Django 的命令列工具集，在之間的博客中已經有所設計了，manage.py 是創建 Django 專案自動生成的檔案， 二者在使用的時候除了語法有差異，能做同樣的事情

例如啟動網站，我們常用的 python manage.py runserver，用 django-admin 修改命令為：django-admim runserver ，

如果你想一直使用 django-admin，那需要提前配置好 DJANGO_SETTINGS_MODULE 環境變數，這個提前配置就有一定的技術難度了，具體實作如下，

首先找到 manage.py 檔案，在里面找到環境變數設定為 cutegirl.settings，如下圖所示，

復制該值，將其存放到電腦環境變數中，

這樣去專案目錄運行我們的程式，會出現一個錯誤，例外如下：

ModuleNotFoundError: No module named 'cutegirl'

模塊例外，這時還要找到 Python 安裝目錄，然后在該目錄下尋找如下檔案夾 Python37\Lib\site-packages，在該檔案中創建 django-site.pth 檔案，檔案中寫入 cutegirl 專案目錄，實作如下：

接下來準備作業完成，就可以運行 django-admin 命令了，得到下述內容表示運行成功，輸出內容也羅列在了下方，這些都是后續要學習的參考內容，

cutegirl> django-admin

Type 'django-admin help <subcommand>' for help on a specific subcommand.

Available subcommands:

[auth]
    changepassword
    createsuperuser

[contenttypes]
    remove_stale_contenttypes
[django]
    check
    compilemessages
    createcachetable
    dbshell
    diffsettings
    dumpdata
    flush
    inspectdb
    loaddata
    makemessages
    makemigrations
    migrate
    sendtestemail
    shell
    showmigrations
    sqlflush
    sqlmigrate
    sqlsequencereset
    squashmigrations
    startapp
    startproject
    test
    testserver

[sessions]
    clearsessions

[staticfiles]
    collectstatic
    findstatic
    runserver

準確的說以下三個命令都是相同的，

django-admin runserver
python manage.py runserver
python -m django runserver

都可以出現如下啟動詳情：

Django version 3.1.7, using settings 'cutegirl.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.

15.2 必會的 help

學習任何命令都要先學會使用幫助手冊，help 命令就是用于這個用于的，
以下兩個命令出現內容一致，都是上文所示命令展示，

django-admin
django-admin help

還可以使用 help 查詢指定命令幫助檔案，
格式如下：

django-admin help 命令名

django-admin help --commands
django-admin help runserver

運行效果如下所示，

15.3 檢查 check

check 命令用來檢查整個 Django 專案是否存在錯誤，

默認使用方式為：

django-admin check

輸出：

System check identified no issues (0 silenced).

如果希望授權檢查特定的應用，只需要修改命令如下所示即可，

django-admin check auth scoring

通過呼叫 --list-tags 可以查看全部可用的應用，

django-admin check --list-tags

基于上述命令的輸出，你可以嘗試下述寫法，

django-admin check --tag urls

15.4 dbshell

使用 settings.py 檔案中 ENGINE 設定中指定的資料庫引擎的命令列客戶端，默認的是喚起 Sqlite3 資料庫命令列客戶端，

>django-admin dbshell
CommandError: You appear not to have the 'sqlite3' program installed or on your path.

但是運行程序中出現了如下 BUG，該內容是由于 Django 只集成 了 Sqlite3 的訪問介面，并沒有可執行檔案，下載可執行檔案 sqlite3.exe，然后放置到 C:\Windwos\System32 中即可，

這里給大家找到了一個直接下載的鏈接，可以 點擊下載 即可，也可以自行打開官網尋找最新的 sqlite3.exe，

再次運行之后，得到下圖所示內容：

>django-admin dbshell
SQLite version 3.7.14.1 2012-10-04 19:37:12
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
sqlite>

15.5 dumpdata

輸出指定應用，例如本例（scoring）中的指定模型的資料，

> django-admin dumpdata scoring.score
[{"model": "scoring.score", "pk": 1, "fields": {"customer": 1, "score": 50}}, {"model": "scoring.score", "pk": 2, "fields": {"customer": 2,
 "score": 30}}, {"model": "scoring.score", "pk": 3, "fields": {"customer": 2, "score": 0}}, {"model": "scoring.score", "pk": 4, "fields": {
"customer": 2, "score": 0}}]

增加一個 --indent=4 可以對結果進行格式化輸出，使用 --output 可以將資料保存到檔案中，

> django-admin dumpdata scoring.score --indent=4
[
{
    "model": "scoring.score",
    "pk": 1,
    "fields": {
        "customer": 1,
        "score": 50
    }
},

15.6 遷移

Django 通過遷移（migrate）命令將 Model 中的修改寫入到資料庫中，

makemigrations
根據模型變化生成遷移代碼，遷移代碼會存放在每個應用下的 migrations 檔案夾，如下圖所示，

如果模型沒有變化，會得到如下結果，

> django-admin makemigrations scoring
No changes detected in app 'scoring'

這里可以擴展一下相關遷移的生成方式，

# 生成一個空遷移
django-admin makemigrations scoring --empty
# 固定名稱生成
django-admin makemigrations scoring --empty --name xiangpi

migrate
使資料庫狀態與當前模型遷移集同步，即把模型的最新狀態部署到資料庫，
該命令的語法格式為：

django-admin migrate [app_label] [migration_name]

如果提供了 migration_name，系統會把資料庫回滾到指定版本，

sqlmigrate
該命令可以將某個 migrate 輸出為 SQL 陳述句，

> django-admin sqlmigrate scoring 0001_initial

showmigrations
顯示專案中所有的遷移檔案，

15.7 其它零碎小命令

version
查看 Django 版本，

cutegirl>django-admin version
3.1.7

makemessages
用于國際化和本地化時，生成 .po 檔案，

compilemessages
編譯 .po 訊息檔案為 .mo 檔案，

上述兩個命令都用在國際化和本地化上面，未使用階段了解即可，

createcachetable
在 settings.py 中配置 CACHES 即可實作快取表功能，

diffsettings

django-admin diffsettings

顯示當前 settings.py 檔案與 Django 的默認設定之間的差異，

flush

django-admin flush

清空當前資料庫的資料，保留 migration 的變更不會被清除，只洗掉資料，不洗掉表結構，

inspectdb
通過已有資料庫表生成 models.py 檔案，也可以將視圖創建為模型檔案，

loaddata
將 fixture 檔案加載到資料庫中，其中 fixture 是序列化好的檔案，檔案格式一般為 JSON 和 XML，

startproject 和 startapp
創建專案和創建 APP 應用，

runserver
啟用 Django 提供的輕量級的 Web 服務器，該服務器一般用于開發測驗，在生產環境中不能使用，

changepassword
當使用了 Django 的認證系統之后，可以修改用戶密碼，

createsuperuser
建立超級用戶.

clearsessions
清除過期的會話，

15.8 本篇博客小節

本篇博客重點解釋了 Django 中的 django-admin 命令列，更多的內容可以去查詢 官方手冊

本文為大家羅列了最常用的一部門，

相關閱讀

1. Python 爬蟲 100 例教程，超棒的爬蟲教程，立即訂閱吧
2. Python 游戲世界（更新中，目標文章數 50+，現在訂閱，都是老粉）
3. Python 爬蟲小課，精彩 9 講，只要 9 塊 9

今天是持續寫作的第 135 / 200 天，
如果你想跟博主建立親密關系，可以關注同名公眾號 夢想橡皮擦，近距離接觸一個逗趣的互聯網高級網蟲，
博主 ID：夢想橡皮擦，希望大家點贊、評論、收藏，