在开始学习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开发之路打下基础!