取得運行時說明¶

django-admin help¶

執行 django-admin help 以顯示使用資訊和每個應用程式提供的命令清單。

執行 django-admin help --commands 以顯示所有可用命令的清單。

執行 django-admin help <command> 以顯示給定命令的描述及其可用選項的清單。

應用程式名稱¶

許多命令都需要「應用程式名稱」的清單。「應用程式名稱」是包含您的模型的套件的基本名稱。例如，如果您的 INSTALLED_APPS 包含字串 'mysite.blog'，則應用程式名稱為 blog。

判斷版本¶

django-admin version¶

執行 django-admin version 以顯示目前的 Django 版本。

輸出遵循 PEP 440 中描述的結構。

1.4.dev17026
1.4a1
1.4

顯示除錯輸出¶

使用 --verbosity（在支援的情況下），以指定 django-admin 列印到主控台的通知和除錯資訊量。

check¶

django-admin check [app_label [app_label ...]]¶

使用 系統檢查框架 來檢查整個 Django 專案中是否存在常見問題。

預設情況下，將會檢查所有應用程式。您可以透過提供應用程式標籤清單作為引數來檢查部分應用程式。

django-admin check auth admin myapp

--tag TAGS, -t TAGS¶

系統檢查框架會執行許多不同類型的檢查，這些檢查 以標籤分類。您可以使用這些標籤將執行的檢查限制為特定類別中的檢查。例如，若要僅執行模型和相容性檢查，請執行：

django-admin check --tag models --tag compatibility

--database DATABASE¶

指定執行需要資料庫存取的檢查的資料庫

django-admin check --database default --database other

預設情況下，不會執行這些檢查。

--list-tags¶

列出所有可用標籤。

--deploy¶

啟動一些僅在部署設定中相關的其他檢查。

您可以在本機開發環境中使用此選項，但由於本機開發設定模組可能沒有許多生產設定，因此您可能會希望將 check 命令指向不同的設定模組，方法是設定 DJANGO_SETTINGS_MODULE 環境變數，或傳遞 --settings 選項。

django-admin check --deploy --settings=production_settings

或者，您也可以直接在生產或預備部署上執行它，以驗證是否正在使用正確的設定（省略 --settings）。您甚至可以將其納入整合測試套件中。

--fail-level {CRITICAL,ERROR,WARNING,INFO,DEBUG}¶

指定導致命令以非零狀態結束的訊息層級。預設值為 ERROR。

compilemessages¶

django-admin compilemessages¶

將 makemessages 建立的 .po 檔案編譯為 .mo 檔案，以用於內建的 gettext 支援。請參閱 國際化和在地化。

--locale LOCALE, -l LOCALE¶

指定要處理的語系。如果未提供，則會處理所有語系。

--exclude EXCLUDE, -x EXCLUDE¶

指定要排除在處理之外的語系。如果未提供，則不會排除任何語系。

--use-fuzzy, -f¶

在編譯檔案中包含 模糊翻譯。

用法範例

django-admin compilemessages --locale=pt_BR
django-admin compilemessages --locale=pt_BR --locale=fr -f
django-admin compilemessages -l pt_BR
django-admin compilemessages -l pt_BR -l fr --use-fuzzy
django-admin compilemessages --exclude=pt_BR
django-admin compilemessages --exclude=pt_BR --exclude=fr
django-admin compilemessages -x pt_BR
django-admin compilemessages -x pt_BR -x fr

--ignore PATTERN, -i PATTERN¶

忽略符合給定 glob 樣式模式的目錄。多次使用可忽略更多目錄。

用法範例

django-admin compilemessages --ignore=cache --ignore=outdated/*/locale

createcachetable¶

django-admin createcachetable¶

使用您設定檔中的資訊，建立用於資料庫快取後端的快取表格。請參閱Django 的快取框架以取得更多資訊。

--database DATABASE¶

指定將建立快取表格的資料庫。預設為 default。

--dry-run¶

印出將執行的 SQL，但不會實際執行，以便您可以自訂它或使用遷移框架。

dbshell¶

django-admin dbshell¶

使用您的 ENGINE 設定中指定的資料庫引擎，以及您的 USER、PASSWORD 等設定中指定的連線參數，執行資料庫引擎的命令列用戶端。

• 對於 PostgreSQL，這會執行 psql 命令列用戶端。

• 對於 MySQL，這會執行 mysql 命令列用戶端。

• 對於 SQLite，這會執行 sqlite3 命令列用戶端。

• 對於 Oracle，這會執行 sqlplus 命令列用戶端。

此命令假設這些程式在您的 PATH 中，以便呼叫程式名稱（psql、mysql、sqlite3、sqlplus）時能在正確的位置找到程式。沒有辦法手動指定程式的位置。

--database DATABASE¶

指定要開啟 shell 的資料庫。預設為 default。

-- ARGUMENTS¶

在 -- 分隔符號之後的任何引數都將傳遞給底層的命令列用戶端。例如，對於 PostgreSQL，您可以使用 psql 命令的 -c 旗標直接執行原始 SQL 查詢

$ django-admin dbshell -- -c 'select current_user'
 current_user
--------------
 postgres
(1 row)

...\> django-admin dbshell -- -c 'select current_user'
 current_user
--------------
 postgres
(1 row)

在 MySQL/MariaDB 上，您可以使用 mysql 命令的 -e 旗標來執行此操作

$ django-admin dbshell -- -e "select user()"
+----------------------+
| user()               |
+----------------------+
| djangonaut@localhost |
+----------------------+

...\> django-admin dbshell -- -e "select user()"
+----------------------+
| user()               |
+----------------------+
| djangonaut@localhost |
+----------------------+

diffsettings¶

django-admin diffsettings¶

顯示目前設定檔與 Django 預設設定之間的差異（或由 --default 指定的另一個設定檔）。

預設設定中未出現的設定會以 "###" 作為後綴。例如，預設設定不會定義 ROOT_URLCONF，因此在 diffsettings 的輸出中，ROOT_URLCONF 會以 "###" 作為後綴。

--all¶

顯示所有設定，即使它們具有 Django 的預設值。這類設定會以 "###" 作為前綴。

--default MODULE¶

要與目前設定進行比較的設定模組。留空以與 Django 的預設設定進行比較。

--output {hash,unified}¶

指定輸出格式。可用值為 hash 和 unified。hash 是預設模式，會顯示如上所述的輸出。unified 顯示類似於 diff -u 的輸出。預設設定會以減號作為前綴，接著是以加號作為前綴的變更設定。

dumpdata¶

django-admin dumpdata [app_label[.ModelName] [app_label[.ModelName] ...]]¶

將與指定應用程式相關聯的資料庫中的所有資料輸出到標準輸出。

如果未提供應用程式名稱，則會傾印所有已安裝的應用程式。

dumpdata 的輸出可以用作 loaddata 的輸入。

當 dumpdata 的結果儲存為檔案時，它可以作為 fixture 用於 測試，或作為 初始資料。

請注意，dumpdata 使用模型上的預設管理器來選取要傾印的記錄。如果您使用 自訂管理器 作為預設管理器，並且它會篩選某些可用的記錄，則不會傾印所有物件。

--all, -a¶

使用 Django 的基礎管理器，傾印可能被自訂管理器篩選或修改的記錄。

--format FORMAT¶

指定輸出的序列化格式。預設為 JSON。支援的格式列於 序列化格式 中。

--indent INDENT¶

指定要在輸出中使用的縮排空格數。預設為 None，這會將所有資料顯示在單行上。

--exclude EXCLUDE, -e EXCLUDE¶

防止傾印特定的應用程式或模型（以 app_label.ModelName 的形式指定）。如果您指定模型名稱，則只會排除該模型，而不是整個應用程式。您也可以混合應用程式名稱和模型名稱。

如果您要排除多個應用程式，請多次傳遞 --exclude

django-admin dumpdata --exclude=auth --exclude=contenttypes

--database DATABASE¶

指定要從中傾印資料的資料庫。預設為 default。

--natural-foreign¶

使用 natural_key() 模型方法來序列化任何外鍵和多對多關係到定義該方法的類型物件。如果您要傾印 contrib.auth Permission 物件或 contrib.contenttypes ContentType 物件，您可能應該使用此旗標。請參閱 自然鍵 文件以取得關於此和下一個選項的更多詳細資訊。

--natural-primary¶

省略此物件序列化資料中的主鍵，因為它可以在還原序列化期間計算出來。

--pks PRIMARY_KEYS¶

僅輸出由逗號分隔的主鍵清單指定的物件。這僅在傾印一個模型時可用。預設情況下，會輸出模型的所有記錄。

--output OUTPUT, -o OUTPUT¶

指定要將序列化資料寫入的檔案。預設情況下，資料會輸出到標準輸出。

當設定此選項且 --verbosity 大於 0（預設值）時，終端機中會顯示進度條。

django-admin dumpdata -o mydata.json.gz

flush¶

django-admin flush¶

從資料庫移除所有資料，並重新執行任何同步後處理常式。已套用遷移的表格不會被清除。

如果您寧願從空的資料庫開始並重新執行所有遷移，您應該刪除並重新建立資料庫，然後執行 migrate。

--noinput, --no-input¶

抑制所有使用者提示。

--database DATABASE¶

指定要清除的資料庫。預設為 default。

inspectdb¶

django-admin inspectdb [table [table ...]]¶

檢視由 NAME 設定指向的資料庫中的資料庫表格，並將 Django 模型模組（models.py 檔案）輸出到標準輸出。

您可以透過傳遞表格或視圖的名稱作為引數來選擇要檢視的表格或視圖。如果未提供任何引數，則僅在使用 --include-views 選項時才會為視圖建立模型。如果在 PostgreSQL 上使用 --include-partitions 選項，則會為分割區表格建立模型。

如果您有一個想要與 Django 一起使用的舊資料庫，請使用此功能。該腳本將檢查資料庫並為其中的每個表格建立一個模型。

正如您可能預期的那樣，建立的模型將為表格中的每個欄位都有一個屬性。請注意，inspectdb 在其欄位名稱輸出中有一些特殊情況

• 如果 inspectdb 無法將欄位的類型對應到模型欄位類型，它將使用 TextField 並在產生模型中的欄位旁邊插入 Python 註解 'This field type is a guess.'。可識別的欄位可能取決於 INSTALLED_APPS 中列出的應用程式。例如，django.contrib.postgres 為幾個 PostgreSQL 特定的欄位類型增加了識別。

• 如果資料庫欄位名稱是 Python 保留字（例如 'pass'、'class' 或 'for'），inspectdb 將在屬性名稱後面附加 '_field'。例如，如果表格有一個欄位 'for'，產生的模型將有一個欄位 'for_field'，並且 db_column 屬性設定為 'for'。inspectdb 將在欄位旁邊插入 Python 註解 'Field renamed because it was a Python reserved word.'。

此功能旨在作為捷徑，而不是最終的模型產生方式。在您執行它之後，您會想要自己查看產生的模型以進行自訂。特別是，您需要重新排列模型的順序，以便引用其他模型的模型能正確排序。

當在模型欄位上指定 default 時，Django 不會建立資料庫預設值。同樣地，資料庫預設值不會轉換為模型欄位預設值，或以任何方式被 inspectdb 偵測到。

預設情況下，inspectdb 會建立非受管的模型。也就是說，模型 Meta 類別中的 managed = False 告訴 Django 不要管理每個表格的建立、修改和刪除。如果您確實想要允許 Django 管理表格的生命週期，您需要將 managed 選項更改為 True（或刪除它，因為 True 是其預設值）。

loaddata¶

django-admin loaddata fixture [fixture ...]¶

搜尋並將指定 固定裝置 的內容載入到資料庫中。

--database DATABASE¶

指定要將資料載入的資料庫。預設為 default。

--ignorenonexistent, -i¶

忽略自最初產生固定裝置以來可能已移除的欄位和模型。

--app APP_LABEL¶

指定單一應用程式以在其中尋找固定裝置，而不是在所有應用程式中尋找。

--format FORMAT¶

指定用於從 標準輸入讀取的固定裝置的序列化格式 (例如，json 或 xml)。

--exclude EXCLUDE, -e EXCLUDE¶

排除從指定的應用程式和/或模型載入固定裝置（格式為 app_label 或 app_label.ModelName）。多次使用此選項可排除多個應用程式或模型。

django-admin loaddata --format=json -

django-admin dumpdata --format=json --database=test app_label.ModelName | django-admin loaddata --format=json --database=prod -

makemessages¶

django-admin makemessages¶

執行目前目錄的整個原始碼樹狀結構，並提取所有標記為翻譯的字串。它會在 conf/locale（在 Django 樹狀結構中）或 locale（適用於專案和應用程式）目錄中建立（或更新）訊息檔案。在對訊息檔案進行變更後，您需要使用 compilemessages 編譯它們，以便與內建的 gettext 支援一起使用。有關詳細資訊，請參閱 i18n 文件。

此命令不需要設定組態。但是，當未設定設定時，此命令無法忽略 MEDIA_ROOT 和 STATIC_ROOT 目錄，或是包含 LOCALE_PATHS。

--all, -a¶

更新所有可用語言的訊息檔案。

--extension EXTENSIONS, -e EXTENSIONS¶

指定要檢查的檔案副檔名清單（預設值：如果 --domain 為 djangojs，則為 html、txt、py 或 js）。

用法範例

django-admin makemessages --locale=de --extension xhtml

以逗號分隔多個副檔名，或多次使用 -e 或 --extension

django-admin makemessages --locale=de --extension=html,txt --extension xml

--locale LOCALE, -l LOCALE¶

指定要處理的地區設定。

--exclude EXCLUDE, -x EXCLUDE¶

指定要排除在處理之外的語系。如果未提供，則不會排除任何語系。

用法範例

django-admin makemessages --locale=pt_BR
django-admin makemessages --locale=pt_BR --locale=fr
django-admin makemessages -l pt_BR
django-admin makemessages -l pt_BR -l fr
django-admin makemessages --exclude=pt_BR
django-admin makemessages --exclude=pt_BR --exclude=fr
django-admin makemessages -x pt_BR
django-admin makemessages -x pt_BR -x fr

--domain DOMAIN, -d DOMAIN¶

指定訊息檔案的網域。支援的選項為：

• django 適用於所有 *.py、*.html 和 *.txt 檔案（預設值）

• djangojs 適用於 *.js 檔案

--symlinks, -s¶

在尋找新的翻譯字串時，追蹤目錄的符號連結。

用法範例

django-admin makemessages --locale=de --symlinks

--ignore PATTERN, -i PATTERN¶

忽略與給定的 glob 樣式模式相符的檔案或目錄。多次使用可忽略更多項目。

預設會使用下列模式：'CVS'、'.*'、'*~'、'*.pyc'。

用法範例

django-admin makemessages --locale=en_US --ignore=apps/* --ignore=secret/*.html

--no-default-ignore¶

停用 --ignore 的預設值。

--no-wrap¶

停用在語言檔案中將長訊息行斷成數行。

--no-location¶

禁止在語言檔案中寫入「#: filename:line」註解行。使用此選項會使技術嫻熟的翻譯人員更難理解每個訊息的上下文。

--add-location [{full,file,never}]¶

控制語言檔案中的 #: filename:line 註解行。如果此選項是

• full（如果未指定，則為預設值）：行包含檔案名稱和行號。

• file：行號會省略。

• never：行會被禁止（與 --no-location 相同）。

需要 gettext 0.19 或更新版本。

--no-obsolete¶

從 .po 檔案中移除過時的訊息字串。

--keep-pot¶

防止刪除在建立 .po 檔案之前產生的暫時 .pot 檔案。這對於除錯可能會阻止建立最終語言檔案的錯誤很有用。

makemigrations¶

django-admin makemigrations [app_label [app_label ...]]¶

根據偵測到的模型變更建立新的遷移。遷移、它們與應用程式的關聯性以及更多內容，會在 遷移文件 中深入介紹。

將一個或多個應用程式名稱作為引數提供，會將建立的遷移限制為指定的應用程式和所需的任何相依性（例如，ForeignKey 另一端的表格）。

若要將遷移新增至沒有 migrations 目錄的應用程式，請使用應用程式的 app_label 執行 makemigrations。

--noinput, --no-input¶

禁止所有使用者提示。如果無法自動解決被禁止的提示，則命令將以錯誤碼 3 結束。

--empty¶

輸出指定應用程式的空白遷移，以供手動編輯。這是針對進階使用者，除非您熟悉遷移格式、遷移作業以及遷移之間的相依性，否則不應使用。

--dry-run¶

顯示將會建立的遷移，而不會實際將任何遷移檔案寫入磁碟。將此選項與 --verbosity 3 一起使用，也會顯示將會寫入的完整遷移檔案。

--merge¶

啟用遷移衝突的修復。

--name NAME, -n NAME¶

允許為產生的遷移命名，而不是使用產生的名稱。名稱必須是有效的 Python 識別符號。

--no-header¶

產生遷移檔案時不包含 Django 版本和時間戳記標頭。

--check¶

當偵測到模型變更但沒有遷移時，會使 makemigrations 以非零狀態結束。暗示 --dry-run。

--scriptable¶

將日誌輸出和輸入提示重新導向至 stderr，僅將產生的遷移檔案路徑寫入 stdout。

--update¶

將模型變更合併到最新的遷移中，並最佳化產生的操作。

更新後的遷移將會產生一個名稱。為了保留先前的名稱，請使用 --name 進行設定。

migrate¶

django-admin migrate [app_label] [migration_name]¶

將資料庫狀態與目前的一組模型和遷移同步。遷移、它們與應用程式的關係等在遷移文件中有詳細介紹。

此命令的行為會根據提供的參數而變化。

• 沒有參數：所有應用程式都會執行其所有遷移。

• <app_label>：指定的應用程式會執行其遷移，直到最新的遷移。由於相依性，這可能也會涉及執行其他應用程式的遷移。

• <app_label> <migrationname>：將資料庫架構帶到已套用指定遷移的狀態，但不會套用同一應用程式中較晚的遷移。如果您之前已遷移超過指定的遷移，這可能會涉及取消套用遷移。您可以使用遷移名稱的前綴，例如 0001，只要它對於給定的應用程式名稱是唯一的即可。使用名稱 zero 回溯所有遷移，也就是還原應用程式的所有已套用遷移。

--database DATABASE¶

指定要遷移的資料庫。預設為 default。

--fake¶

將直到目標遷移的遷移（遵循上述規則）標記為已套用，但實際上不會執行 SQL 來變更您的資料庫架構。

這是為了讓進階使用者可以直接操作目前的遷移狀態，如果他們正在手動套用變更；請注意，使用 --fake 會有將遷移狀態表置於需要手動復原才能使遷移正確執行的風險。

--fake-initial¶

如果所有使用該遷移中所有 CreateModel 操作所建立的模型名稱的資料庫表格已經存在，則允許 Django 跳過應用程式的初始遷移。此選項旨在首次針對在遷移使用之前就已存在的資料庫執行遷移時使用。然而，此選項除了比對表格名稱之外，不會檢查是否符合資料庫架構，因此僅當您確信現有架構與初始遷移中記錄的架構相符時才可安全使用。

--plan¶

顯示將針對給定的 migrate 命令執行的遷移操作。

--run-syncdb¶

允許為沒有遷移的應用程式建立表格。雖然不建議這樣做，但在具有數百個模型的大型專案中，遷移框架有時會太慢。

--noinput, --no-input¶

抑制所有使用者提示。例如，提示詢問是否移除過時的內容類型。

--check¶

當偵測到未套用的遷移時，會使 migrate 以非零狀態結束。

--prune¶

從 django_migrations 表格中刪除不存在的遷移。當已被壓縮遷移取代的遷移檔案遭到移除時，這非常有用。如需更多詳細資訊，請參閱壓縮遷移。

optimizemigration¶

django-admin optimizemigration app_label migration_name¶

最佳化指定遷移的操作並覆寫現有檔案。如果遷移包含必須手動複製的函式，此命令會建立一個新的遷移檔案，並加上 _optimized 的後綴，此檔案旨在取代指定的遷移。

--check¶

當遷移可以最佳化時，會使 optimizemigration 以非零狀態結束。

runserver¶

django-admin runserver [addrport]¶

在本機上啟動一個輕量級的開發網頁伺服器。預設情況下，伺服器在 IP 位址 127.0.0.1 的 8000 埠上執行。您可以明確傳入 IP 位址和埠號。

如果您以具有一般權限的使用者身分執行此指令碼（建議），您可能沒有權限在較低的埠號上啟動埠。較低的埠號保留給超級使用者（root）。

此伺服器使用 WSGI_APPLICATION 設定所指定的 WSGI 應用程式物件。

開發伺服器會根據每個請求自動重新載入 Python 程式碼。您不需要為了讓程式碼變更生效而重新啟動伺服器。然而，某些動作，例如新增檔案，不會觸發重新啟動，所以在這些情況下您必須重新啟動伺服器。

如果您使用 Linux 或 MacOS，並且同時安裝了 pywatchman 和 Watchman 服務，將會使用核心訊號來自動重新載入伺服器 (而不是每秒輪詢檔案修改時間戳記)。這在大型專案上能提供更好的效能、程式碼變更後減少回應時間、更穩健的變更偵測，並降低耗電量。Django 支援 pywatchman 1.2.0 及更高版本。

當您啟動伺服器，以及每次在伺服器執行時變更 Python 程式碼時，系統檢查框架將會檢查您的整個 Django 專案是否有常見錯誤 (請參閱 check 命令)。如果發現任何錯誤，它們將會列印到標準輸出。您可以使用 --skip-checks 選項來跳過執行系統檢查。

您可以執行任意數量的並行伺服器，只要它們透過多次執行 django-admin runserver 來使用不同的埠即可。

請注意，預設 IP 位址 127.0.0.1 無法從您網路上的其他電腦存取。若要讓您的開發伺服器可讓網路上其他電腦檢視，請使用其自身的 IP 位址 (例如 192.168.2.1)、0 ( 0.0.0.0 的縮寫)、0.0.0.0 或 :: (啟用 IPv6 時)。

您可以提供用括號括住的 IPv6 位址 (例如 [200a::1]:8000)。這將自動啟用 IPv6 支援。

也可以使用僅包含 ASCII 字元的 hostname。

如果啟用了 staticfiles contrib 應用程式 (新專案中的預設值)，則 runserver 命令將會被它自己的 runserver 命令覆寫。

伺服器的每個請求和回應的記錄都會傳送到 django.server 記錄器。

--noreload¶

停用自動重新載入器。這表示如果特定的 Python 模組已經載入到記憶體中，那麼您在伺服器執行時所做的任何 Python 程式碼變更都將不會生效。

--nothreading¶

停用開發伺服器中的執行緒使用。預設情況下，伺服器是多執行緒的。

--ipv6, -6¶

使用 IPv6 作為開發伺服器。這會將預設 IP 位址從 127.0.0.1 變更為 ::1。

django-admin runserver

django-admin runserver 1.2.3.4:8000

django-admin runserver 7000

django-admin runserver 1.2.3.4:7000

django-admin runserver -6

django-admin runserver -6 7000

django-admin runserver [2001:0db8:1234:5678::9]:7000

django-admin runserver localhost:8000

django-admin runserver -6 localhost:8000

sendtestemail¶

django-admin sendtestemail [email [email ...]]¶

將測試電子郵件 (以確認透過 Django 發送電子郵件是否正常運作) 發送到指定的收件者。例如

django-admin sendtestemail foo@example.com bar@example.com

有幾個選項，您可以一起使用它們的任何組合

--managers¶

使用 mail_managers() 將電子郵件發送到 MANAGERS 中指定的電子郵件地址。

--admins¶

使用 mail_admins() 將電子郵件發送到 ADMINS 中指定的電子郵件地址。

shell¶

django-admin shell¶

啟動 Python 互動式直譯器。

--interface {ipython,bpython,python}, -i {ipython,bpython,python}¶

指定要使用的 shell。依預設，如果安裝了 IPython 或 bpython，Django 將會使用它們。如果兩者都安裝了，請指定您想要哪一個，如下所示

IPython

django-admin shell -i ipython

bpython

django-admin shell -i bpython

如果您已安裝「豐富」的 shell，但想要強制使用「純」Python 直譯器，請使用 python 作為介面名稱，如下所示

django-admin shell -i python

--no-startup¶

停用讀取「純」Python 直譯器的啟動腳本。依預設，會讀取 PYTHONSTARTUP 環境變數或 ~/.pythonrc.py 腳本指向的腳本。

--command COMMAND, -c COMMAND¶

讓您可以傳遞命令作為字串，以便作為 Django 執行，如下所示

django-admin shell --command="import django; print(django.__version__)"

您也可以將程式碼從標準輸入傳入以執行它。例如

$ django-admin shell <<EOF
> import django
> print(django.__version__)
> EOF

在 Windows 上，由於該平台上 select.select() 的實作限制，會輸出 REPL。

showmigrations¶

django-admin showmigrations [app_label [app_label ...]]¶

顯示專案中的所有遷移。您可以從以下兩種格式中選擇一種

--list, -l¶

列出 Django 所知道的所有應用程式、每個應用程式可用的遷移，以及是否已套用每個遷移 (在遷移名稱旁邊以 [X] 標示)。對於 2 或更高的 --verbosity，也會顯示套用日期時間。

也會列出沒有遷移的應用程式，但它們下方會印出 (no migrations)。

這是預設輸出格式。

--plan, -p¶

顯示 Django 將遵循的遷移計畫以套用遷移。如同 --list，已套用的遷移會以 [X] 標記。當 --verbosity 設定為 2 或以上時，也會顯示遷移的所有相依性。

app_label 參數會限制輸出，但是，提供的應用程式的相依性也可能會被包含在內。

--database DATABASE¶

指定要檢查的資料庫。預設為 default。

sqlflush¶

django-admin sqlflush¶

印出 flush 命令將執行的 SQL 語句。

--database DATABASE¶

指定要印出 SQL 的資料庫。預設為 default。

sqlmigrate¶

django-admin sqlmigrate app_label migration_name¶

印出指定遷移的 SQL。這需要一個活動的資料庫連線，它將使用該連線來解析約束名稱；這表示您必須針對您希望稍後套用的資料庫副本產生 SQL。

請注意，sqlmigrate 不會為其輸出著色。

--backwards¶

產生用於取消套用遷移的 SQL。預設情況下，建立的 SQL 是用於以正向方向執行遷移。

--database DATABASE¶

指定要產生 SQL 的資料庫。預設為 default。

sqlsequencereset¶

django-admin sqlsequencereset app_label [app_label ...]¶

印出用於重置給定應用程式名稱的序列的 SQL 語句。

序列是一些資料庫引擎用來追蹤自動遞增欄位下一個可用數字的索引。

使用此命令來產生 SQL，以修復序列與其自動遞增欄位資料不同步的情況。

--database DATABASE¶

指定要印出 SQL 的資料庫。預設為 default。

squashmigrations¶

django-admin squashmigrations app_label [start_migration_name] migration_name¶

將 app_label 的遷移壓縮至（包含）migration_name，盡可能減少遷移數量。壓縮後的遷移可以安全地與未壓縮的遷移並存。如需更多資訊，請閱讀 壓縮遷移。

當給定 start_migration_name 時，Django 將只包含從此遷移開始（包含此遷移）的遷移。這有助於減輕 RunPython 和 django.db.migrations.operations.RunSQL 遷移操作的壓縮限制。

--no-optimize¶

在產生壓縮遷移時停用最佳化器。預設情況下，Django 會嘗試最佳化遷移中的操作，以減少產生的檔案大小。如果此過程失敗或建立不正確的遷移，請使用此選項，但請同時提交有關該行為的 Django 錯誤報告，因為最佳化應該是安全的。

--noinput, --no-input¶

抑制所有使用者提示。

--squashed-name SQUASHED_NAME¶

設定壓縮遷移的名稱。省略時，名稱會根據第一個和最後一個遷移，中間加上 _squashed_。

--no-header¶

產生沒有 Django 版本和時間戳記標頭的壓縮遷移檔案。

startapp¶

django-admin startapp name [directory]¶

在目前目錄或給定的目的地中，為給定的應用程式名稱建立 Django 應用程式目錄結構。

預設情況下，新目錄包含一個 models.py 檔案和其他應用程式範本檔案。如果只給定應用程式名稱，則應用程式目錄將在目前工作目錄中建立。

如果提供了可選的目的地，Django 將使用該現有的目錄，而不是建立新目錄。您可以使用「.」來表示目前的工作目錄。

例如

django-admin startapp myapp /Users/jezdez/Code/myapp

--template TEMPLATE¶

提供自訂應用程式範本檔案的目錄路徑，或包含應用程式範本檔案的未壓縮封存檔 (.tar) 或壓縮封存檔 (.tar.gz、.tar.bz2、.tar.xz、.tar.lzma、.tgz、.tbz2、.txz、.tlz、.zip)。

例如，這會在建立 myapp 應用程式時，在給定的目錄中尋找應用程式範本

django-admin startapp --template=/Users/jezdez/Code/my_app_template myapp

Django 也會接受指向壓縮封存檔的 URL (http、https、ftp)，其中包含應用程式範本檔案，並動態下載和解壓縮它們。

例如，利用 GitHub 將存放庫作為 zip 檔案公開的功能，您可以使用類似以下的 URL

django-admin startapp --template=https://github.com/githubuser/django-app-template/archive/main.zip myapp

--extension EXTENSIONS, -e EXTENSIONS¶

指定應該使用範本引擎呈現應用程式範本中的哪些檔案副檔名。預設為 py。

--name FILES, -n FILES¶

指定應該使用範本引擎呈現應用程式範本中的哪些檔案（除了符合 --extension 的檔案）。預設為空列表。

--exclude DIRECTORIES, -x DIRECTORIES¶

指定應該排除應用程式範本中的哪些目錄，除了 .git 和 __pycache__。如果未提供此選項，則名稱為 __pycache__ 或以 . 開頭的目錄將會被排除。

所有相符檔案所使用的 範本 context 為：

• 傳遞給 startapp 命令的任何選項（在該命令支援的選項中）

• app_name – 傳遞給命令的應用程式名稱

• app_directory – 新建立應用程式的完整路徑

• camel_case_app_name – 以駝峰式大小寫格式表示的應用程式名稱

• docs_version – 文件版本：'dev' 或 '1.x'

• django_version – Django 的版本，例如 '2.0.3'

startproject¶

django-admin startproject name [directory]¶

在目前目錄或指定的目的地，為給定的專案名稱建立 Django 專案目錄結構。

預設情況下，新目錄 包含 manage.py 和一個專案套件（包含 settings.py 和其他檔案）。

如果只給定專案名稱，專案目錄和專案套件都會被命名為 <projectname>，且專案目錄將會在目前的工作目錄中建立。

如果提供了可選的目的地，Django 會使用該現有目錄作為專案目錄，並在其中建立 manage.py 和專案套件。使用「.」來表示目前的工作目錄。

例如

django-admin startproject myproject /Users/jezdez/Code/myproject_repo

--template TEMPLATE¶

指定自訂專案範本的目錄、檔案路徑或 URL。請參閱 startapp --template 文件以取得範例和用法。

--extension EXTENSIONS, -e EXTENSIONS¶

指定專案範本中應使用範本引擎渲染的檔案副檔名。預設值為 py。

--name FILES, -n FILES¶

指定專案範本中除了與 --extension 相符的檔案之外，應使用範本引擎渲染的檔案。預設值為空清單。

--exclude DIRECTORIES, -x DIRECTORIES¶

指定專案範本中除了 .git 和 __pycache__ 之外，應排除的目錄。如果未提供此選項，則會排除名稱為 __pycache__ 或以 . 開頭的目錄。

所使用的 範本 context 為：

• 傳遞給 startproject 命令的任何選項（在該命令支援的選項中）

• project_name – 傳遞給命令的專案名稱

• project_directory – 新建立專案的完整路徑

• secret_key – SECRET_KEY 設定的隨機金鑰

• docs_version – 文件版本：'dev' 或 '1.x'

• django_version – Django 的版本，例如 '2.0.3'

另請參閱針對 startapp 所述的 渲染警告 和 受信任的程式碼警告。

test¶

django-admin test [test_label [test_label ...]]¶

執行所有已安裝應用程式的測試。如需更多資訊，請參閱Django 中的測試。

--failfast¶

在測試失敗後立即停止執行測試並回報失敗。

--testrunner TESTRUNNER¶

控制用於執行測試的測試執行器類別。此值會覆寫 TEST_RUNNER 設定所提供的值。

--noinput, --no-input¶

抑制所有使用者提示。典型的提示是關於刪除現有測試資料庫的警告。

$ python -m pip install tblib

testserver¶

django-admin testserver [fixture [fixture ...]]¶

使用給定 fixture 中的資料執行 Django 開發伺服器（如 runserver 中所述）。

例如，此命令

django-admin testserver mydata.json

…將會執行下列步驟

1. 建立測試資料庫，如測試資料庫中所述。

2. 使用給定 fixture 中的 fixture 資料來填入測試資料庫。（如需 fixture 的詳細資訊，請參閱上面 loaddata 的文件。）

3. 執行 Django 開發伺服器（如 runserver 中所述），並將其指向這個新建立的測試資料庫，而不是您的生產資料庫。

這在許多方面都很有用

• 當您編寫檢視如何使用特定 fixture 資料運作的單元測試時，您可以使用 testserver 在網頁瀏覽器中手動與檢視互動。

• 假設您正在開發 Django 應用程式，並且有一個您想要互動的「原始」資料庫副本。您可以將資料庫匯出到fixture (使用dumpdata 命令，如上所述)，然後使用 testserver 執行您的 Web 應用程式並使用該資料。透過這樣的安排，您可以靈活地以任何方式弄亂您的資料，因為您知道無論您進行任何資料更改，都只會對測試資料庫進行。

請注意，此伺服器不會自動偵測您的 Python 原始碼的變更 (如同runserver 的行為)。但是，它會偵測樣板的變更。

--addrport ADDRPORT¶

指定與預設的 127.0.0.1:8000 不同的連接埠，或 IP 位址和連接埠。此值的格式與runserver 命令的引數完全相同，並且功能也完全相同。

範例

要在連接埠 7000 上執行測試伺服器，並使用 fixture1 和 fixture2

django-admin testserver --addrport 7000 fixture1 fixture2
django-admin testserver fixture1 fixture2 --addrport 7000

(上面的敘述是等效的。我們同時包含它們是為了說明選項是在 fixture 引數之前還是之後都無關緊要。)

要在 1.2.3.4:7000 上執行，並使用 test fixture

django-admin testserver --addrport 1.2.3.4:7000 test

--noinput, --no-input¶

抑制所有使用者提示。典型的提示是關於刪除現有測試資料庫的警告。

django.contrib.auth¶

django-admin changepassword ringo

django.contrib.contenttypes¶

django.contrib.gis¶

django.contrib.sessions¶

django.contrib.staticfiles¶

語法著色¶

DJANGO_COLORS¶

如果您的終端機支援 ANSI 彩色輸出，則 django-admin / manage.py 指令將使用漂亮的彩色編碼輸出。如果您將指令的輸出管線傳輸到另一個程式，除非使用 --force-color 選項，否則它將不會使用色彩代碼。

export DJANGO_COLORS="light"

export DJANGO_COLORS="error=yellow/blue,blink;notice=magenta"

export DJANGO_COLORS="light;error=yellow/blue,blink;notice=magenta"

Bash 完成¶

如果您使用 Bash shell，請考慮安裝 Django bash 完成腳本，該腳本位於 Django 來源發行版的 extras/django_bash_completion 中。它啟用 django-admin 和 manage.py 指令的 Tab 完成，因此您可以，例如…

• 輸入 django-admin。

• 按下 [TAB] 鍵以查看所有可用的選項。

• 輸入 sql，然後按下 [TAB] 鍵，以查看所有名稱以 sql 開頭的可用的選項。

請參閱如何建立自訂 django-admin 命令，以了解如何新增自訂動作。

Black 格式化¶

由 startproject、startapp、optimizemigration、makemigrations 和 squashmigrations 建立的 Python 檔案，如果您的 PATH 中存在 black 命令，則會使用該命令進行格式化。

如果您已全域安裝 black，但不希望目前專案使用它，您可以明確設定 PATH。

PATH=path/to/venv/bin django-admin makemigrations

對於使用 stdout 的命令，您可以根據需要將輸出導向到 black。

django-admin inspectdb | black -