Flask路由參數：動態URL與變量捕獲

在使用Flask開發Web應用時，我們經常需要根據不同的用戶、文章、商品等展示個性化內容。例如，用戶訪問/user/Alice時顯示Alice的個人主頁，訪問/post/123時顯示ID爲123的文章詳情。這些需求無法通過靜態路由（如@app.route('/user/Alice')）實現，因爲靜態路由只能匹配固定URL。此時，動態URL參數就能派上用場——通過在路由中嵌入可變參數，Flask會自動捕獲這些參數並傳遞給視圖函數，從而靈活處理不同場景。

一、動態URL參數的基本語法¶

Flask的動態URL參數使用尖括號<>包裹參數名，語法格式爲：

@app.route('/路徑/<參數名>')

其中，<參數名>會捕獲URL中對應位置的字符串，並將其作爲參數傳遞給視圖函數。

示例：基礎動態路由¶

例如，定義一個用戶主頁路由，通過username參數展示不同用戶的頁面：

from flask import Flask

app = Flask(__name__)

# 動態路由：捕獲字符串類型的 username 參數
@app.route('/user/<username>')
def user_profile(username):
    return f"你好，{username}！歡迎來到個人主頁~"

if __name__ == '__main__':
    app.run(debug=True)

訪問測試：
啓動應用後，訪問http://localhost:5000/user/小明，頁面會返回：你好，小明！歡迎來到個人主頁~。
此時，Flask自動將URL中的小明作爲username參數傳遞給user_profile函數。

二、數據類型限制¶

動態參數默認是字符串類型，但有時需要限制參數類型（如整數ID、浮點數評分）。Flask支持多種內置類型，格式爲：/<類型:參數名>，常見類型包括：

類型	說明	示例URL
`int`	僅允許整數，非整數返回404	`/post/<int:post_id>`
`float`	僅允許浮點數	`/price/<float:price>`
`path`	允許包含斜槓（路徑參數）	`/files/<path:file>`

示例：帶類型限制的路由¶

整數ID路由：

@app.route('/post/<int:post_id>')
def show_post(post_id):
    return f"文章ID爲 {post_id} 的詳情頁"

訪問/post/123會返回：文章ID爲 123 的詳情頁；若訪問/post/abc（非整數），Flask會自動返回404錯誤。

路徑參數：
path類型允許URL中包含斜槓，常用於文件路徑場景：

@app.route('/file/<path:file_path>')
def download_file(file_path):
    return f"正在下載文件：{file_path}"

訪問/file/documents/report.pdf會返回：正在下載文件：documents/report.pdf。

三、多參數路由¶

路由中可以同時捕獲多個參數，視圖函數需對應接收多個參數。

示例：多參數動態路由¶

@app.route('/book/<string:book_name>/<int:chapter>')
def book_chapter(book_name, chapter):
    return f"《{book_name}》第 {chapter} 章"

訪問/book/Python編程/5會返回：《Python編程》第 5 章。
此時，路由中捕獲了兩個參數：book_name（字符串）和chapter（整數），視圖函數需按順序接收這兩個參數。

四、實際應用場景¶

動態URL參數的典型應用場景包括：
- 用戶中心：/user/<username>（展示不同用戶的個人信息）
- 文章詳情：/post/<int:post_id>（展示指定ID的文章內容）
- 搜索功能：/search/<string:keyword>（根據關鍵詞搜索結果）
- 商品頁面：/product/<int:product_id>（展示商品詳情）

五、注意事項¶

參數名一致性：路由中的參數名必須與視圖函數的參數名完全一致，否則無法接收參數。

   # 錯誤示例：參數名不一致
   @app.route('/user/<username>')
   def profile(name):  # 參數名應爲username，此處用name會報錯
       return f"Hello, {name}"

路由匹配順序：多個路由可能匹配同一URL前綴，需注意順序。例如：

   # 正確：優先定義帶類型的路由（int比string更具體）
   @app.route('/user/<int:id>')  # 處理整數ID
   def user_id(id):
       return f"用戶ID：{id}"

   @app.route('/user/<string:name>')  # 處理字符串名
   def user_name(name):
       return f"用戶姓名：{name}"

參數非必需性：動態參數是URL的一部分，必須出現在路徑中，否則返回404（無法省略）。

總結¶

動態URL參數是Flask路由的核心功能，通過<參數名>語法捕獲可變參數，並支持類型限制（如int、float），可靈活處理不同用戶或資源的個性化請求。掌握動態路由後，你可以快速實現用戶中心、文章詳情、搜索結果等常見頁面，讓Web應用更具擴展性和靈活性。