在開始學習Flask之前,我們先來簡單瞭解一下它是什麼。Flask是一個輕量級的Python Web框架,就像搭積木一樣靈活,適合初學者快速上手開發簡單的網站或Web應用。它不需要太多複雜配置,就能讓你寫出能在瀏覽器中訪問的頁面,非常適合作爲Web開發的入門工具。
一、準備Python環境¶
要使用Flask,首先得安裝Python。Python是Flask的運行基礎,就像蓋房子需要地基一樣。
1. 下載並安裝Python¶
- 官網下載:打開瀏覽器,訪問Python官網(https://www.python.org/),點擊“Downloads”選擇適合你係統的Python版本(建議選3.x系列,比如Python 3.9或更新版本)。
- 安裝步驟:
- Windows用戶:安裝時一定要勾選“Add Python to PATH”(添加到系統環境變量),這一步能讓你在命令行直接使用Python命令,避免後續配置麻煩。
- Mac/Linux用戶:通常預裝了Python,但可能是舊版本。建議通過官方指南升級到Python 3.x(比如用
brew install python3或系統自帶的安裝工具)。
2. 驗證Python安裝¶
安裝完成後,打開命令行(Windows按Win+R輸入“cmd”,Mac/Linux直接打開終端),輸入以下命令:
python --version
如果顯示類似Python 3.9.7的版本號,說明Python安裝成功了!
二、安裝Flask¶
Python安裝好後,就可以用pip(Python的“應用商店”)安裝Flask了。pip是Python自帶的包管理工具,用來下載和安裝第三方庫。
1. 安裝Flask¶
在命令行輸入:
pip install flask
如果安裝速度慢(因爲國外服務器),可以用國內鏡像加速:
pip install flask -i https://pypi.tuna.tsinghua.edu.cn/simple
稍等片刻,Flask就會自動下載並安裝到你的Python環境中。
2. 驗證Flask安裝¶
安裝完成後,輸入以下命令檢查版本:
flask --version
如果顯示類似Flask 2.3.3的版本信息,說明安裝成功了!
三、(可選但推薦)使用虛擬環境¶
如果你是新手,可能會覺得“虛擬環境”聽起來複雜,但它其實是爲了幫你隔離不同項目的依賴,避免“一個項目用了舊版本庫,導致另一個項目崩潰”的問題。就像不同房間放不同傢俱,不會互相干擾。
1. 創建虛擬環境¶
在命令行中,先新建一個項目文件夾(比如叫my_flask_project),進入文件夾後執行:
python -m venv venv
這會在當前文件夾下生成一個venv文件夾,裏面就是你的虛擬環境。
2. 激活虛擬環境¶
- Windows用戶:
venv\Scripts\activate
激活後,命令行前綴會顯示(venv),表示現在進入了虛擬環境。
- Mac/Linux用戶:
source venv/bin/activate
3. 退出虛擬環境¶
在虛擬環境中開發完成後,輸入deactivate即可退出。
四、創建第一個Flask應用¶
現在我們來寫一個最簡單的Flask程序,讓它在瀏覽器中顯示“Hello, Flask!”。
1. 新建項目文件¶
在項目文件夾(比如my_flask_project)中,新建一個文本文件,改名爲app.py(Python文件必須用.py後綴)。
2. 編寫代碼¶
用記事本或簡單的編輯器(比如VS Code)打開app.py,輸入以下代碼:
# 導入Flask類(就像請來了一個“Web搭建專家”)
from flask import Flask
# 創建Flask應用實例(app是核心對象,__name__表示當前文件名稱)
app = Flask(__name__)
# 定義“路由”:訪問網站根目錄(http://127.0.0.1:5000/)時,執行下面的函數
@app.route('/')
def hello():
# 返回給瀏覽器的內容(就像做菜後裝盤)
return 'Hello, Flask! 這是我的第一個網頁~'
# 主程序入口:當直接運行app.py時,啓動Flask服務器
if __name__ == '__main__':
# 啓動服務器,debug=True表示開啓“調試模式”(代碼改了自動重啓,不用手動重啓)
app.run(debug=True)
3. 運行Flask應用¶
在命令行中,確保虛擬環境已激活(前綴顯示(venv)),進入項目文件夾,執行:
python app.py
如果看到類似以下輸出,說明服務器啓動成功:
* Serving Flask app 'app'
* Debug mode: on
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
4. 訪問應用¶
打開瀏覽器,輸入http://127.0.0.1:5000/(或http://localhost:5000/),你會看到瀏覽器顯示“Hello, Flask! 這是我的第一個網頁~”,恭喜!你的第一個Flask應用成功運行了!
五、常見問題及解決辦法¶
1. 安裝Flask失敗?¶
- 原因:可能是
pip沒升級,或者網絡問題。 - 解決:先升級
pip:
python -m pip install --upgrade pip
再重新安裝Flask。
2. 端口被佔用?¶
- 原因:Flask默認用5000端口,如果這個端口被其他程序佔用(比如你之前開了另一個Flask項目),就會報錯。
- 解決:修改代碼中
app.run()的端口,比如改爲8080:
app.run(port=8080, debug=True) # 現在用8080端口,訪問 http://127.0.0.1:8080/
3. 代碼改了沒反應?¶
- 原因:如果沒開
debug=True,修改代碼後需要手動重啓服務器,很麻煩。 - 解決:確保代碼中
app.run(debug=True)的debug=True,這樣代碼修改後服務器會自動重啓。
六、總結¶
現在你已經完成了Flask開發環境的搭建,並且寫出了能在瀏覽器訪問的第一個網頁。接下來可以嘗試修改代碼,比如在@app.route('/')下添加另一個路由(比如@app.route('/about')),寫一個新的視圖函數返回不同的內容,看看能不能在新的URL(http://127.0.0.1:5000/about)中訪問到。
記住,編程學習最重要的是多動手實踐,哪怕只是修改一行代碼,運行後看到結果,都是成長的過程。Flask的靈活性很高,後續還能學習路由參數、模板渲染、數據庫連接等更復雜的功能,爲你的Web開發之路打下基礎!