用 30 行 Python 做出你的第一個網站：Flask 入門

雙擊 index.html，跟打開 localhost:5000，差在哪？

學完 HTML、CSS、JavaScript 之後，你大概做過一個作品：滑鼠雙擊 index.html，瀏覽器打開，網址列顯示 file:///C:/Users/...。看起來像一個網站，但其實它只是一份「檔案」——你的瀏覽器在讀一份寫死在硬碟上的文字檔，沒有任何程式在背後運算，內容永遠不會變。

真正的網站不是這樣運作的。你在瀏覽器打 google.com，Google 的伺服器收到請求後，跑了一段程式，算出這次要回傳什麼內容，才把結果送回你的瀏覽器。這中間多了一個角色：後端——一台隨時待命、能運算、能查資料庫的伺服器程式。

Flask 就是用 Python 寫這種伺服器最輕量的工具。這篇文章會帶你從安裝開始，寫出第一支會動的網站，看懂「請求進來 → 路由比對 → 函式運算 → 回傳網頁」這個後端最核心的流程。

安裝 Flask

Flask 需要 Python 3.9 以上版本（先在命令列打 python --version 確認）。建議先建一個虛擬環境，避免套件裝進系統全域環境互相打架：

# 建立虛擬環境
python -m venv venv

# 啟動虛擬環境（Windows）
venv\Scripts\activate

# 啟動虛擬環境（macOS / Linux）
source venv/bin/activate

# 安裝 Flask（目前最新穩定版是 3.1.3）
pip install Flask

看到命令列前面出現 (venv) 字樣，代表虛擬環境已啟動。裝完之後可以打 flask --version 確認版本號，看到 Flask 3.1.3 就代表裝好了。

第一支 Flask app：幾行程式看懂請求與回應

在資料夾裡新增一個 app.py，貼上這段：

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello, Flask！你好，世界'

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

命令列輸入 python app.py，如果看到：

 * Running on http://127.0.0.1:5000

打開瀏覽器連到 http://127.0.0.1:5000（或），就會看到「Hello, Flask！你好，世界」。這一步是本篇最重要的檢查點——，這是新手最常卡住的第一步，順序記反了（先開瀏覽器、後啟動伺服器）也會出現「無法連線」。

一個網站，多個路由

一個網站當然不會只有一個頁面。要新增頁面，就是多寫幾組「路由 + 函式」：

from flask import Flask

app = Flask(__name__)

@app.route('/')
def home():
    return '這是首頁'

@app.route('/about')
def about():
    return '關於我們'

@app.route('/contact')
def contact():
    return '聯絡方式'

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

用 render_template 把 HTML 獨立出來

前面的例子都是直接 return 一段文字，實際網站當然要回傳完整的 HTML 頁面，而且 HTML 應該跟 Python 邏輯分開放，不然檔案會愈寫愈亂。Flask 的做法是把 HTML 放進固定名稱的 templates 資料夾（注意有 s，拼錯或放錯資料夾是 `TemplateNotFound` 錯誤最大的來源），再用 render_template 讀進來：

my_app/
├── app.py
├── templates/
│   └── index.html
└── static/
    └── style.css

templates/index.html 內容：

<!DOCTYPE html>
<html lang="zh-Hant">
<head><meta charset="UTF-8"><title>我的網站</title></head>
<body>
    <h1>哈囉，{{ name }}！</h1>
    <ul>
    {% for hobby in hobbies %}
        <li>{{ hobby }}</li>
    {% endfor %}
    </ul>
</body>
</html>

卡關自救清單

寫 Flask 時最常見的幾個坑，遇到先對照這張表：

症狀	原因
瀏覽器顯示「無法連線」	命令列沒看到 `Running on http://...`，伺服器根本沒啟動成功
`TemplateNotFound`	HTML 沒放進 `templates/` 資料夾，或資料夾名稱、檔名拼錯
`Address already in use`	Port 5000 被前一個沒關掉的 Flask app 佔用，改成 `app.run(port=5001)` 或先關掉舊的
改了程式碼但畫面沒變	`debug=True` 沒開，或伺服器沒重新啟動
`NameError: render_template`	忘了在最上面 `from flask import Flask, render_template`