在使用Flask開發應用時，隨着功能增多，代碼文件會變得越來越長，路由管理也會變得混亂。這時，Flask的藍圖（Blueprint） 功能就能派上用場了。藍圖就像一個“功能模板”，可以幫助我們把不同模塊的路由和視圖函數分組管理，讓項目結構更清晰、代碼更易維護。
爲什麼需要藍圖？¶
想象一下，如果我們在一個app.py文件裏寫了所有路由：用戶註冊、商品列表、訂單管理……隨着功能越來越多，代碼會像麪條一樣糾纏不清。這時候，藍圖的作用就顯現了：
- 模塊化分組：把不同功能的路由（比如用戶相關、商品相關）拆分成獨立的“藍圖”，每個藍圖負責一部分功能。
- 代碼結構清晰：不同模塊的代碼隔離，團隊協作時更容易分工。
- 避免循環導入：大型項目中，模塊間的依賴容易導致循環導入錯誤，藍圖可以減少這種問題。
- 複用性：藍圖可以被多個項目複用，或者在同一個項目中多次註冊。
藍圖實戰：從0開始創建模塊化應用¶
步驟1：項目結構設計¶
我們先規劃一個簡單的項目結構，包含一個主應用和兩個藍圖模塊（用戶模塊和商品模塊）：
myapp/
├── app.py # 主應用入口
├── user/ # 用戶模塊藍圖
│ ├── __init__.py # 初始化文件
│ └── routes.py # 用戶相關路由
└── product/ # 商品模塊藍圖
├── __init__.py
└── routes.py # 商品相關路由
app.py：主應用，負責註冊所有藍圖並啓動服務。user/routes.py：用戶模塊的路由定義。product/routes.py：商品模塊的路由定義。
步驟2：創建用戶模塊藍圖（user）¶
在user/routes.py中，我們創建一個藍圖實例，並定義用戶相關的路由：
# user/routes.py
from flask import Blueprint, render_template
# 創建藍圖實例：第一個參數是藍圖名稱（唯一標識），第二個參數是__name__（當前模塊名）
user_bp = Blueprint('user', __name__)
# 定義用戶相關路由（注意：用藍圖的route裝飾器，而非app.route）
@user_bp.route('/profile')
def profile():
return "用戶個人資料頁面"
@user_bp.route('/login')
def login():
return "用戶登錄頁面"
步驟3：創建商品模塊藍圖（product）¶
同理，在product/routes.py中定義商品相關路由：
# product/routes.py
from flask import Blueprint
# 創建商品模塊藍圖
product_bp = Blueprint('product', __name__)
# 商品相關路由
@product_bp.route('/list')
def product_list():
return "商品列表頁面"
@product_bp.route('/detail/<int:pid>')
def product_detail(pid):
return f"商品詳情頁：ID={pid}"
步驟4：主應用註冊藍圖（app.py）¶
在主應用app.py中，導入藍圖並註冊：
# app.py
from flask import Flask
from user.routes import user_bp # 導入用戶藍圖
from product.routes import product_bp # 導入商品藍圖
app = Flask(__name__)
# 註冊藍圖：url_prefix參數可給藍圖路由加前綴（如/user/profile）
app.register_blueprint(user_bp, url_prefix='/user')
app.register_blueprint(product_bp, url_prefix='/product')
if __name__ == '__main__':
app.run(debug=True)
步驟5：測試路由¶
運行app.py後，訪問以下URL驗證效果：
- 用戶模塊：http://localhost:5000/user/profile（個人資料）、http://localhost:5000/user/login（登錄）
- 商品模塊：http://localhost:5000/product/list（商品列表）、http://localhost:5000/product/detail/123（商品詳情，ID=123）
藍圖的進階用法¶
除了路由分組，藍圖還支持：
1. 模板路徑隔離¶
如果模塊內有自己的模板文件，可以在創建藍圖時指定template_folder：
# user/__init__.py （或在routes.py中）
user_bp = Blueprint('user', __name__, template_folder='templates')
此時，用戶模塊的模板應放在user/templates/user/profile.html，主應用的模板放在templates/下，Flask會優先查找藍圖的模板。
2. 靜態文件隔離¶
類似模板，藍圖也可以指定static_folder來管理模塊內的靜態資源：
product_bp = Blueprint('product', __name__, static_folder='static')
商品模塊的靜態文件放在product/static/下，訪問路徑爲/product/static/xxx.js。
3. 藍圖前綴與子域名¶
- 前綴：如步驟4中的
url_prefix='/user'，可統一給模塊路由加前綴，避免路徑衝突。 - 子域名：通過
subdomain參數，藍圖可僅響應特定子域名（如subdomain='admin'）。
總結¶
藍圖是Flask模塊化開發的核心工具，通過它我們可以：
- 將複雜應用拆分爲獨立模塊，降低維護成本。
- 讓路由管理更清晰，代碼結構更符合邏輯。
- 爲大型項目的團隊協作和複用提供便利。
建議初學者從第一個小項目就開始使用藍圖，養成“模塊化”的開發習慣。隨着項目複雜度提升，藍圖會成爲你管理代碼的得力助手！