專案佈局

建立專案目錄並進入

$ mkdir flask-tutorial
$ cd flask-tutorial

然後依照安裝指示設定 Python 虛擬環境，並為您的專案安裝 Flask。

本教學將假設您從現在起在 flask-tutorial 目錄下工作。每個程式碼區塊頂部的文件名稱都與此目錄相關。

---

一個 Flask 應用程式可以簡單到只有單一檔案。

hello.py

from flask import Flask

app = Flask(__name__)


@app.route('/')
def hello():
    return 'Hello, World!'

然而，隨著專案變大，將所有程式碼放在一個檔案中會變得難以負荷。Python 專案使用套件來將程式碼組織成多個模組，這些模組可以在需要時導入，本教學也將這樣做。

專案目錄將包含

• flaskr/，一個包含您的應用程式程式碼和檔案的 Python 套件。

• tests/，一個包含測試模組的目錄。

• .venv/，一個 Python 虛擬環境，Flask 和其他依賴項安裝於此。

• 安裝檔案，告知 Python 如何安裝您的專案。

• 版本控制設定，例如 git。您應該養成對所有專案使用某種版本控制的習慣，無論專案大小。

• 您未來可能新增的任何其他專案檔案。

到最後，您的專案佈局會看起來像這樣

/home/user/Projects/flask-tutorial
├── flaskr/
│   ├── __init__.py
│   ├── db.py
│   ├── schema.sql
│   ├── auth.py
│   ├── blog.py
│   ├── templates/
│   │   ├── base.html
│   │   ├── auth/
│   │   │   ├── login.html
│   │   │   └── register.html
│   │   └── blog/
│   │       ├── create.html
│   │       ├── index.html
│   │       └── update.html
│   └── static/
│       └── style.css
├── tests/
│   ├── conftest.py
│   ├── data.sql
│   ├── test_factory.py
│   ├── test_db.py
│   ├── test_auth.py
│   └── test_blog.py
├── .venv/
├── pyproject.toml
└── MANIFEST.in

如果您使用版本控制，則在執行專案時產生的以下檔案應被忽略。根據您使用的編輯器，可能還有其他檔案。一般來說，忽略您沒有編寫的檔案。例如，使用 git

.gitignore

.venv/

*.pyc
__pycache__/

instance/

.pytest_cache/
.coverage
htmlcov/

dist/
build/
*.egg-info/

繼續閱讀應用程式設定。