保命錦囊¶

這裡整理了在 Django 開發過程中常用的指令，方便快速查詢。

說明

如果看到 ${xxx} (xxx 可能被替換成任意詞) 代表你在使用這個指令時 ${xxx} 需要替代成其他東西，不要直接貼

例如：

${command} 代表這段需要被替換成指令
${version} 代表需要被替換成版本

uv 相關指令¶

虛擬環境

操作 uv 相關指令時，如需要虛擬環境，但虛擬環境不存在會自動建立。

安裝與版本¶

列出當前的 uv 版本

uv --version

列出可用的 Python 版本

uv python list

安裝指定版本的 Python

uv python install ${version}

安裝 Python 3.14

uv python install 3.14

設定專案使用的 Python 版本（建立 .python-version）

uv python pin ${version}

固定 Python 版本為 3.14

uv python pin 3.14

專案管理¶

初始化新專案

uv init

初始化專案使用 Python 3.14

uv init --python 3.14

套件管理¶

安裝套件

uv add ${package_name}

安裝 Django

uv add django

移除套件

uv remove ${package_name}

移除 Django

uv remove django

安裝套件到指定分組

uv add --group=${group_name} ${package_name}

安裝 ipython 到 dev 分組

uv add --group=dev ipython

從指定分組移除套件

uv remove --group=${group_name} ${package_name}

從 dev 分組移除 ipython

uv remove --group=dev ipython

根據專案依賴紀錄（uv.lock 檔案）安裝所有套件

uv sync

執行指令¶

在虛擬環境中執行指令

uv run ${command}

在虛擬環境中執行 Django 指令

uv run django-admin --version

在虛擬環境中執行 Python 檔案

uv run ${python_file}

在虛擬環境中執行 Python 檔 main.py

uv run main.py

在虛擬環境中執行 Python 互動環境

uv run python

虛擬環境¶

啟動虛擬環境

WindowsmacOS / Linux

.venv\Scripts\activate

source .venv/bin/activate

離開虛擬環境

deactivate

Django 相關指令¶

版本與專案建立¶

查看 Django 版本

uv run django-admin --version

建立 Django 專案（在當前目錄）

uv run django-admin startproject ${project_name} .

在當前目錄建立 Django 專案名稱為 core

uv run django-admin startproject core .

注意事項

指令最後有一個 . 代表當前目錄

建立 Django 專案中的應用（APP）

uv run django-admin startapp ${app_name}

在當前目錄建立 Django APP 名稱為 todo

uv run django-admin startapp todo .

開發伺服器¶

啟動開發伺服器

uv run manage.py runserver

資料庫相關¶

建立遷移檔案

uv run manage.py makemigrations

執行資料庫遷移

uv run manage.py migrate

使用者管理¶

建立超級使用者

uv run manage.py createsuperuser

其他實用指令¶

開啟 Django Shell

uv run manage.py shell

檢查專案是否有問題

uv run manage.py check

收集靜態檔案

uv run manage.py collectstatic

Emmet 語法¶

參考 https://docs.emmet.io/cheat-sheet/