技術小白必學:Flask開發環境搭建全流程

在開始學習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開發之路打下基礎!

小夜